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

**URL:** <https://discourse.cmake.org/t/cmake-org-cmake-help-search-results-are-often-disappointing/1730>\
**Category:** Community\
**Created:** [August 20, 2020, 6:09pm UTC](https://discourse.cmake.org/t/cmake-org-cmake-help-search-results-are-often-disappointing/1730 "2020-08-20T18:09:24Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![AndrewGaspar](https://discourse.cmake.org/user_avatar/discourse.cmake.org/andrewgaspar/32/137_2.png) [@AndrewGaspar](https://discourse.cmake.org/u/AndrewGaspar)\
**Post date:** [August 20, 2020, 6:09pm UTC](https://discourse.cmake.org/t/cmake-org-cmake-help-search-results-are-often-disappointing/1730/1 "2020-08-20T18:09:24Z")

</div>

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

 ![image](https://discourse.cmake.org/uploads/default/original/1X/b2caf8ad8744300af923238b61262608c66c5ec2.png)

---

<div class="post-metadata">

**Author:** ![AndrewGaspar](https://discourse.cmake.org/user_avatar/discourse.cmake.org/andrewgaspar/32/137_2.png) [@AndrewGaspar](https://discourse.cmake.org/u/AndrewGaspar)\
**Post date:** [August 20, 2020, 6:10pm UTC](https://discourse.cmake.org/t/cmake-org-cmake-help-search-results-are-often-disappointing/1730/2 "2020-08-20T18:10:32Z")

</div>

Result 10:

 ![image](https://discourse.cmake.org/uploads/default/original/1X/fa824bc6cc097698826ee3cf9511321fa6917581.png)

---

<div class="post-metadata">

**Author:** ![kyle.edwards](https://discourse.cmake.org/letter_avatar_proxy/v4/letter/k/65b543/32.png) [@kyle.edwards](https://discourse.cmake.org/u/kyle.edwards)\
**Post date:** [August 20, 2020, 7:31pm UTC](https://discourse.cmake.org/t/cmake-org-cmake-help-search-results-are-often-disappointing/1730/3 "2020-08-20T19:31:07Z")

</div>

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

---

<div class="post-metadata">

**Author:** ![ferdnyc](https://discourse.cmake.org/user_avatar/discourse.cmake.org/ferdnyc/32/267_2.png) [@ferdnyc](https://discourse.cmake.org/u/ferdnyc)\
**Post date:** [August 21, 2020, 9:48am UTC](https://discourse.cmake.org/t/cmake-org-cmake-help-search-results-are-often-disappointing/1730/4 "2020-08-21T09:48:49Z")

</div>

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.