I was wondering if there is an overall view of how the various aspects of constructing queries fit together somewhere. The docs deal with each subject individually, often with orphaned code snippet examples that don't show where they fit into the structure. Its like trying to put together a thousand piece jigsaw without a picture on the box lid. I am resorting to finding code samples elsewhere and counting the number of spaces before configuration terms to calculate the indent level to work out where they fit in the structure.
An overview would be nice covering - which query types can fit together and which can't, where does filtering and aggregation fit in, and a way of "seeing" in our heads the structure so we can then build the queries on screen without "bodging about" and tial and error.
The json method of defining queries was probably a good idea in the beginning, but as more and more functionality has been added it has become unweildy.
Have you found the box lid? Willing to share the view of the overall structure?