Docs: Re-scope Intersphinx article as a how-to (readthedocs#9622)

* Docs: Re-scope Intersphinx article as a how-to (title, navigation, intro) * Use Title Case for section headline
kuzmoyev · Oct 4, 2022 · c2f319d · c2f319d
1 parent fb503b5
commit c2f319d
Show file tree

Hide file tree

Showing 2 changed files with 5 additions and 3 deletions.
diff --git a/docs/user/guides/authors.rst b/docs/user/guides/authors.rst
@@ -14,6 +14,6 @@ and :doc:`/intro/getting-started-with-mkdocs`.
    :maxdepth: 1
 
    cross-referencing-with-sphinx
-   intersphinx
+   Link to external projects (Intersphinx) <intersphinx>
    jupyter
    Migrate from rST to MyST <migrate-rest-myst>
diff --git a/docs/user/guides/intersphinx.rst b/docs/user/guides/intersphinx.rst
@@ -1,5 +1,7 @@
-Link to Other Projects' Documentation With Intersphinx
-======================================================
+How to Link to Other Documentation Projects With Intersphinx
+============================================================
+
+This section shows you how to maintain references to named sections of other external Sphinx projects.
 
 You may be familiar with using the :ref:`:ref: role <sphinx:ref-role>` to
 :doc:`link to any location of your docs </guides/cross-referencing-with-sphinx>`.