[WIP] Query builder 2 documentation

| Q             | A
| ------------- | ---
| Doc fix?      | no
| New docs?     | yes 
| Applies to    | 1.0 (?)
| Fixed tickets |