Link previews docs update (#12187)

<!-- readthedocs-preview docs start -->
---
:books: Documentation previews :books:

- User's documentation (`docs`):
https://docs--12187.org.readthedocs.build/12187/

<!-- readthedocs-preview docs end -->

<!-- readthedocs-preview dev start -->
- Developer's documentation (`dev`):
https://dev--12187.org.readthedocs.build/12187/

<!-- readthedocs-preview dev end -->

---------

Co-authored-by: Eric Holscher <[email protected]>

Author: pjfan

docs/user/addons.rst

@@ -37,9 +37,9 @@ Configuring Read the Docs Addons
 
 Individual configuration options for each addon are available in :guilabel:`Settings`.
 
-#. Go to the new :term:`dashboard`:
+#. Go to the new :term:`dashboard`.
 #. Click on a project name.
-#. Go to :guilabel:`Settings`
+#. Go to :guilabel:`Settings`.
 #. In the left bar, go to :guilabel:`Addons`.
 #. Configure each Addon individually.
 

docs/user/link-previews.rst

@@ -10,17 +10,26 @@ so you can keep your context while reading but learn more from other resources.
 
    Example of link previews addon
 
+Link previews will only be generated for internal links--links that point to pages within your documentation site.
+No link previews will be generated for links to external sites or links that appear outside of the primary content of the documentation page (eg. nav bars).
 
+You can see an example of a link preview by hovering over the following link: :doc:`Addons </addons>`.
 
 Enabling link previews
 ----------------------
 
-In your dashboard, you can go to the links preview tag in :guilabel:`Settings > Addons > Link previews` and enable it.
+#. Go to the new :term:`dashboard`.
+#. Click on a project name.
+#. Go to :guilabel:`Settings`, then in the left bar, go to :guilabel:`Addons`.
+#. Go to :guilabel:`Link previews` and check :guilabel:`Enabled`.
+#. Save your settings -- a rebuild of your project isn't required!
 
 Troubleshooting link previews
 -----------------------------
 
 We perform some heuristic to detect the documentation tool used to generate the page based on its HTML structure.
 This auto-detection may fail, resulting in the content rendered inside the popup being incorrect.
-If you are experimenting this, you can specify the CSS selector for the main content in :guilabel:`Settings > Addons > Advanced`,
+If you are experiencing this, you can specify the CSS selector for the main content in :guilabel:`Settings > Addons > Advanced`,
 or you can `open an issue in the addons repository <https://github.com/readthedocs/addons>`_ so we improve our heuristic.
+
+Link previews won't be generated if JavaScript is not enabled in your web browser or if all cookies are blocked.

docs/user/traffic-analytics.rst

@@ -23,7 +23,7 @@ and then click on :guilabel:`Traffic analytics`.
 Enabling traffic analytics
 --------------------------
 
-#. Go to the new :term:`dashboard`:
+#. Go to the new :term:`dashboard`.
 #. Click on a project name.
 #. Go to :guilabel:`Settings`, then in the left bar, go to :guilabel:`Addons`.
 #. Go to :guilabel:`Analytics` and check :guilabel:`Analytics enabled`.