Refactor offline formats docs

Refs #9746
Closes #9577

Author: ericholscher

docs/user/_static/images/guides/offline-formats.jpg

@@ -1,50 +1,42 @@
-Downloadable Documentation
-==========================
+Offline Formats
+===============
 
-Read the Docs supports building multiple formats for Sphinx-based projects:
+Read the Docs supports building multiple offline formats:
 
 * PDF
 * ePub
 * Zipped HTML
 
-This means that every commit that you push will automatically update your PDFs as well as your HTML.
-
-This is enabled by the :ref:`config-file/v2:formats` key in our config file.
-A simple example is here:
-
-.. code-block:: yaml
-
-   # Build PDF & ePub
-   formats:
-     - epub
-     - pdf
-
-If you want to see an example,
-you can download the Read the Docs documentation in the following formats:
-
-    * `PDF`_ 
-    * `ePub`_ 
-    * `Zipped HTML`_ 
-    
-.. _PDF: https://docs.readthedocs.io/_/downloads/en/latest/pdf/
-.. _ePub: https://docs.readthedocs.io/_/downloads/en/latest/epub/
-.. _Zipped HTML: https://docs.readthedocs.io/_/downloads/en/latest/htmlzip/
+This means that every commit that you push will automatically update your these offline formats as well as your HTML.
 
 Use cases
 ---------
 
 This functionality is great for anyone who needs documentation when they aren't connected to the internet.
 Users who are about to get on a plane can grab a PDF and have the entire doc set ready for their trip.
 
-The other value is having the entire docset in a single file.
+The other value is having the entire documentation in a single file.
 You can send a user an email with a single PDF or ePub and they'll have all the docs in one place.
+This is useful for archiving documentation, as well as distributing it in other scenarios.
 
-Deleting downloadable content
------------------------------
+Accessing offline formats
+-------------------------
 
-The entries in the Downloads section of your project dashboard reflect the
-formats specified in your config file for each active version.
+You can download offline formats in the :guilabel:`Project dashboard` > :guilabel:`Downloads`:
 
-This means that if you wish to remove downloadable content for a given version,
-you can do so by removing the matching :ref:`config-file/v2:formats` key from
-your config file.
+.. image::  /_static/images/guides/offline-formats.jpg
+    :width: 75%
+
+Examples
+--------
+
+If you want to see an example,
+you can download the Read the Docs documentation in the following formats:
+
+    * `PDF`_
+    * `ePub`_
+    * `Zipped HTML`_
+
+.. _PDF: https://docs.readthedocs.io/_/downloads/en/latest/pdf/
+.. _ePub: https://docs.readthedocs.io/_/downloads/en/latest/epub/
+.. _Zipped HTML: https://docs.readthedocs.io/_/downloads/en/latest/htmlzip/

docs/user/downloadable-documentation.rst

@@ -17,3 +17,4 @@ and :doc:`/intro/getting-started-with-mkdocs`.
    Link to external projects (Intersphinx) <intersphinx>
    jupyter
    Migrate from rST to MyST <migrate-rest-myst>
+   enable-offline-formats

docs/user/guides/authors.rst

@@ -0,0 +1,40 @@
+How to enable offline formats
+=============================
+
+This guide provides a step-by-step guide to enabling offline formats of your documentation.
+
+They are automatically built by Read the Docs during our default build process,
+as long as you have the configuration enabled to turn this on.
+
+.. note:: Offline formats are currently only available for Sphinx-based documentation when using the Read the Docs build process.
+
+Enabling offline formats
+------------------------
+
+Offline formats are enabled by the :ref:`config-file/v2:formats` key in our config file.
+A simple example is here:
+
+.. code-block:: yaml
+
+   # Build PDF & ePub
+   formats:
+     - epub
+     - pdf
+
+Verifying offline formats
+-------------------------
+
+You can verify that offline formats are building in your :guilabel:`Project dashboard` > :guilabel:`Downloads`:
+
+.. image::  /_static/images/guides/offline-formats.jpg
+    :width: 75%
+
+Deleting offline formats
+------------------------
+
+The entries in the Downloads section of your project dashboard reflect the
+formats specified in your config file for each active version.
+
+This means that if you wish to remove downloadable content for a given version,
+you can do so by removing the matching :ref:`config-file/v2:formats` key from
+your config file.