readthedocs · benjaoming · Dec 22, 2022 · Oct 19, 2022 · Oct 20, 2022 · Oct 21, 2022
diff --git a/docs/user/features.rst b/docs/user/features.rst
@@ -75,20 +75,6 @@ We offer a number of search features:
 
 Learn more about :doc:`/server-side-search/index`.
 
-Traffic Analytics
------------------
-
-Read the Docs aggregates simple statistics about visits to your documentation.
-
-Traffic Analytics lets you see *which* documents your users are reading.
-This allows you to understand how your documentation is being used,
-so you can focus on expanding and updating parts people are reading most.
-
-If you require more detailed analytics, Read the Docs has native support for Google Analytics.
-It's also possible to customize your documentation to include other analytics frameworks.
-
-Learn more in :doc:`/analytics`.
-
 Open Source and Customer Focused
 --------------------------------
 

diff --git a/docs/user/guides/authors.rst b/docs/user/guides/authors.rst
@@ -18,3 +18,4 @@ and :doc:`/intro/getting-started-with-mkdocs`.
    jupyter
    Migrate from rST to MyST <migrate-rest-myst>
    enable-offline-formats
+   Using search analytics <search-analytics>
diff --git a/docs/user/guides/search-analytics.rst b/docs/user/guides/search-analytics.rst
@@ -0,0 +1,6 @@
+How To Use Search Analytics
+===========================
+
+In this guide, you can learn to use Read the Docs' built-in search analytics for your documentation project.
+
+TBC
diff --git a/docs/user/index.rst b/docs/user/index.rst
@@ -102,6 +102,7 @@ to help you create fantastic documentation for your project.
    :glob:
 
    api/index
+   reference/features
 
 
 Read the Docs feature overview

diff --git a/docs/user/reference/analytics.rst b/docs/user/reference/analytics.rst
@@ -0,0 +1,38 @@
+Analytics for Search and Traffic
+================================
+
+Read the Docs supports analytics for search and traffic.
+When someone reads your documentation,
+we collect data about the vist and the referer
+with full respect of the privacy of the visitor.
+
+
+Traffic Analytics
+-----------------
+
+Read the Docs aggregates simple statistics about visits to your documentation.
+
+Traffic Analytics lets you see *which* documents your users are reading.
+This allows you to understand how your documentation is being used,
+so you can focus on expanding and updating parts people are reading most.
+
+If you require more detailed analytics, Read the Docs has native support for Google Analytics.
+It's also possible to customize your documentation to include other analytics frameworks.
+
+Learn more in :doc:`/analytics`.
+
+
+Search Analytics
+----------------
+
+When someone visits your documentation using a search engine,
+Read the Docs will collect analytics on their search term.
+
+Those are aggregated into a simple view of the
+"Top queries in the past 30 days".
+You can also download this data.
+
+This is helpful to optimize your documentation in alignment with your readers' interests.
+You can discover new trends and expand your documentation to new needs.
+
+Learn more in :doc:`/guides/search-analytics`.
diff --git a/docs/user/reference/features.rst b/docs/user/reference/features.rst
@@ -0,0 +1,9 @@
+========
+Features
+========
+
+
+.. toctree::
+   :maxdepth: 1
+
+   analytics
-Original file line number
+Diff line change
@@ Expand Up @@
        :glob:
        api/index
+       reference/features
     Read the Docs feature overview
@@ Expand Down @@