Slightly confusing syntax for querying documents

[phatboyg]

Slightly confusing syntax for querying documents

[phatboyg]

Yeah, the trick is that Query.Create() just creates another parser (combinator). So it isn't really a query as it is a parser. I agree it's confusing, and I get the whole usage of Execute as a term. Just not sure how to apply it nicely.

It's also possible to just type:

var result = parsed.Query(q => ...);

But that creates a new parser every time, versus reusing an existing one (which is faster, if you're doing it a lot).

Another option would be to allow the parser to passed into the same keyword:

var result = parsed.Query(query);

I agree the current syntax is confusing, it's a work in progress to see what is easiest to use. So looking for more input here before it's solidified.

[ahives]

This has totally grown on me. I like your suggestion. The syntax is succinct and it expressive as to what it does so that developers will understand examples clearly. Lets go with that.