The query documentation was a set of examples and spec like filter definitions. There is now a reasonable introduction and some clarification on how brackets are used.
Read the new docs and try out the examples.
Please, prepare your MR for a review. Be sure to write a summary and a focus and create gitlab comments for the reviewer. They should guide the reviewer through the changes, explain your changes and also point out open questions. For further good practices have a look at our review guidelines
For further good practices have a look at our review guidelines.