Search: API V3 (#9625)

* Convert api.py to module api/v2

* Black

* Fix tests

* Search: refactor serializer's context

We were generating the context of the serializer
from outside, but we can do this from
the serializer itself,
this way we don't have to duplicate this logic.

* Search API V3

* Support new syntax in the dashboard

* Black

* Redirect to global search from project search

* Black

* Refactor

* Move server-side-search docs

* Add docs

* Fixes

* Update links

* Fixes

* Fix tests

* Tests

* Linter

* Format

* This shouldn't be here

* Fix import

* Fix tests

* Black

* Fix test

* Updates from review

* Inherit from API v3 settings

* Add a note about using yield

* Rename Backend -> SearchExecutor

* More renaming

* Don't depend on the order

* We can't use dicts in a set :(

* False alarm, we just needed to set the version public

* Set privacy level explicitly

* Override global rate limit

* Comment

Author: stsewd

docs/user/analytics.rst

@@ -16,7 +16,7 @@ and then click on :guilabel:`Traffic Analytics`.
 
    Traffic analytics demo
 
-You can also access to analytics data from :ref:`search results <server-side-search:Search Analytics>`.
+You can also access to analytics data from :ref:`search results <server-side-search/index:Search Analytics>`.
 
 .. note::
 

docs/user/api/v3.rst

@@ -1882,4 +1882,4 @@ Embed
 Additional APIs
 ---------------
 
-- :ref:`Server side search API <server-side-search:api>`.
+- :doc:`Server side search API </server-side-search/api>`.

docs/user/build-customization.rst

@@ -408,7 +408,7 @@ Read the Docs will automatically index the content of all your HTML files,
 respecting the :ref:`search <config-file/v2:search>` options from your config file.
 
 You can access the search results from the :guilabel:`Search` tab of your project,
-or by using the :ref:`search API <server-side-search:api>`.
+or by using the :doc:`/server-side-search/api`.
 
 .. note::
 

docs/user/config-file/v2.rst

@@ -684,7 +684,7 @@ Do a recursive clone of the submodules.
 search
 ~~~~~~
 
-Settings for more control over :doc:`/server-side-search`.
+Settings for more control over :doc:`/server-side-search/index`.
 
 .. code-block:: yaml
 

docs/user/features.rst

@@ -70,10 +70,10 @@ We offer a number of search features:
 
 * Search across :doc:`subprojects </subprojects>`
 * Search results land on the exact content you were looking for
-* Search across projects you have access to (available on |com_brand|)
-* A full range of :doc:`search operators </guides/advanced-search>` including exact matching and excluding phrases.
+* Search across projects you have access to
+* A full range of :doc:`search operators </server-side-search/syntax>` including exact matching and excluding phrases.
 
-Learn more about :doc:`/server-side-search`.
+Learn more about :doc:`/server-side-search/index`.
 
 Open Source and Customer Focused
 --------------------------------

docs/user/flyout-menu.rst

@@ -15,7 +15,7 @@ The flyout menu provides access to the following bits of Read the Docs functiona
 * :doc:`Downloadable formats </downloadable-documentation>` for the current version, including HTML & PDF downloads that are enabled by the project.
 * Links to the Read the Docs dashboard for the project.
 * Links to your :doc:`VCS provider </integrations>` that allow the user to quickly find the exact file that the documentation was rendered from.
-* A search bar that gives users access to our :doc:`/server-side-search` of the current version.
+* A search bar that gives users access to our :doc:`/server-side-search/index` of the current version.
 
 Closed
 ~~~~~~

docs/user/guides/administrators.rst

@@ -14,7 +14,6 @@ have a look at our :doc:`/tutorial/index`.
 
    technical-docs-seo-guide
    manage-translations-sphinx
-   advanced-search
    hiding-a-version
    deprecating-content
    pdf-non-ascii-languages

docs/user/guides/advanced-search.rst

@@ -78,7 +78,7 @@ and some of the core features of Read the Docs.
   :doc:`/versions` |
   :doc:`/downloadable-documentation` |
   :doc:`/hosting` |
-  :doc:`/server-side-search` |
+  :doc:`/server-side-search/index` |
   :doc:`/analytics` |
   :doc:`/pull-requests` |
   :doc:`/build-notifications` |
@@ -111,7 +111,7 @@ and some of the core features of Read the Docs.
    /versions
    /downloadable-documentation
    /hosting
-   /server-side-search
+   /server-side-search/index
    /analytics
    /pull-requests
    /build-notifications
@@ -145,7 +145,6 @@ and how to write successful documentation.
 * **For project administrators**:
   :doc:`/guides/technical-docs-seo-guide` |
   :doc:`/guides/manage-translations-sphinx` |
-  :doc:`/guides/advanced-search` |
   :doc:`/guides/private-submodules` |
   Setup Build Notifications <build-notifications> |
   :doc:`More guides for administrators </guides/administrators>`