cmake.org/cmake/help search results are often disappointing

I’m trying to look up the documentation for option here. The results are not so helpful:

2 Likes

Result 10:

We use Sphinx to generate our documentation, so this is more of a general issue with Sphinx. Perhaps their search heuristics can be improved.

The documentation itself is “okaaay”, mostly, but the search is… not. Seems like it’s just doing a full-text search across the entire contents, while specifically avoiding things like the page titles.

Ideally you’d want it to do the exact opposite, confining its search to the title and/or metadata so it can prioritize those matches first, before it even starts to drill down into fulltext searches.