Docs: Rewrote the filtered query docs to be clearer

Closes #1688