Doc'd how to use Intersphinx in the reusable apps tutorial.

1 files changed, 20 insertions, 0 deletions

diff --git a/docs/intro/reusable-apps.txt b/docs/intro/reusable-apps.txt
index 8c12a36284..f097880f79 100644
--- a/docs/intro/reusable-apps.txt
+++ b/docs/intro/reusable-apps.txt
@@ -262,6 +262,26 @@ this. For a small app like polls, this process isn't too difficult.
    you add some files to it. Many Django apps also provide their documentation
    online through sites like `readthedocs.org <https://readthedocs.org>`_.
 
+   Many Python projects, including Django and Python itself, use `Sphinx
+   <https://www.sphinx-doc.org/en/master/usage/quickstart.html>`_ to build
+   their documentation. If you choose to use Sphinx you can link back to the
+   Django documentation by configuring `Intersphinx
+   <https://www.sphinx-doc.org/en/master/usage/quickstart.html#intersphinx>`_
+   and including a value for Django in your project's ``intersphinx_mapping``
+   value::
+
+        intersphinx_mapping = {
+            # ...
+            "django": (
+                "https://docs.djangoproject.com/en/stable/",
+                "https://docs.djangoproject.com/en/stable/_objects/",
+            ),
+        }
+
+   With that in place, you can then cross-link to specific entries, in the
+   same way as in the Django docs, such as
+   "``:attr:`django.test.TransactionTestCase.databases```".
+
 #. Check that the :pypi:`build` package is installed (``python -m pip install
    build``) and try building your package by running ``python -m build`` inside
    ``django-polls``. This creates a directory called ``dist`` and builds your