Polish the swh-search QL

Make sure it's:

• consistent
• future-proof (we should avoid changing it after users start relying on it)
• user-friendly
• well-documented

---

Migrated from T3560 (view on Phabricator)