Docs: document analytics (#7857)

readthedocs · Mar 5, 2021 · aac2ec2 · aac2ec2
1 parent 1bbf0b4
commit aac2ec2
Show file tree

Hide file tree

Showing 5 changed files with 27 additions and 24 deletions.
diff --git a/docs/_static/images/traffic-analytics-demo.png b/docs/_static/images/traffic-analytics-demo.png
diff --git a/docs/analytics.rst b/docs/analytics.rst
@@ -0,0 +1,24 @@
+Analytics
+---------
+
+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.
+
+To see a list of the top pages from the last month,
+go to the :guilabel:`Admin` tab of your project,
+and then click on :guilabel:`Traffic Analytics`.
+
+.. figure:: /_static/images/traffic-analytics-demo.png
+   :width: 50%
+   :align: center
+   :alt: Traffic analytics demo
+
+   Traffic analytics demo
+
+You can also access to analytics data from :ref:`search results <server-side-search:analytics>`.
+
+.. note::
+
+   If you require more information about page views,
+   you can use a solution like :doc:`Google Analytics </guides/google-analytics>`.
diff --git a/docs/commercial/analytics.rst b/docs/commercial/analytics.rst
diff --git a/docs/commercial/index.rst b/docs/commercial/index.rst
@@ -36,4 +36,3 @@ Advertising-free
    single-sign-on
    sharing
    privacy-level
-   analytics
diff --git a/docs/index.rst b/docs/index.rst
@@ -77,6 +77,7 @@ and some of the core features of Read the Docs.
   :doc:`/downloadable-documentation` |
   :doc:`/hosting` |
   :doc:`/server-side-search` |
+  :doc:`/analytics`
   :doc:`/pull-requests`
 
 * **Connecting with GitHub, BitBucket, or GitLab**:
@@ -102,9 +103,10 @@ and some of the core features of Read the Docs.
    /custom_domains
    /versions
    /downloadable-documentation
+   /hosting
    /server-side-search
+   /analytics
    /pull-requests
-   /hosting
 
    /connected-accounts