Move and update search settings documentation.

Review Request #12585 — Created Sept. 7, 2022 and submitted

Information

Review Board
release-5.0.x

Reviewers

The search documentation was still found deep under "Site Maintenance",
since it originally was just a small doc that explained how to set up
the crontab to run the indexing command. These days we have extensive
setup options (various Elasticsearch dependencies), and ideally if
people are setting up search, they'll also be using on-the-fly indexing.
This change moves the search docs to exist alongside the other documents
for the site settings, and renames it to "Search Settings" since it's
about a lot more than just indexing. While I was doing this, I also
moved the Elasticsearch section to be first, since we definitely want
users to prioritize that over Whoosh.

  • Built HTML docs. Verified that all the links went to the expected
    places, and that the search doc rendered as expected.
Summary ID
Move and update search settings documentation.
The search documentation was still found deep under "Site Maintenance", since it originally was just a small doc that explained how to set up the crontab to run the indexing command. These days we have extensive setup options (various Elasticsearch dependencies), and ideally if people are setting up search, they'll also be using on-the-fly indexing. This change moves the search docs to exist alongside the other documents for the site settings, and renames it to "Search Settings" since it's about a lot more than just indexing. While I was doing this, I also moved the Elasticsearch section to be first, since we definitely want users to prioritize that over Whoosh. Testing Done: - Built HTML docs. Verified that all the links went to the expected places, and that the search doc rendered as expected.
cbb7d39b895d6e26f2999c2b4f7345c745f45abb
chipx86
  1. Ship It!
  2. 
      
david
Review request changed
Status:
Completed
Change Summary:
Pushed to release-5.0.x (ba893f4)