Update documenting_mpl.rst

choldgraf · web-flow · commit c6866a0db83d · 2017-04-28T10:23:27.000-07:00
diff --git a/doc/devel/documenting_mpl.rst b/doc/devel/documenting_mpl.rst
@@ -35,12 +35,12 @@ General structure
 
 All documentation is built from the :file:`doc/` directory. This directory contains both
 ``.rst`` files that contain pages in the documentation, directories that contain more
-``.rst`` files, and configuration files for Sphinx.
+``.rst`` files, and configuration files for Sphinx_.
 
 .. note::
 
   An exception to this are the directories :file:`gallery` and :file:`tutorials`, which
-  exist in the root directory. These contain Python files that are built by ``sphinx-gallery``.
+  exist in the root directory. These contain Python files that are built by `Sphinx Gallery <sphinx_gallery>`_.
   When the docs are built, directories of the same name will be generated inside of :file:`docs/`.
   The generated directories :file:`docs/gallery` and :file:`docs/tutorials` can be safely deleted.
 
@@ -302,11 +302,6 @@ working with Sphinx in general. Here are a few additional things to keep in mind
 * The autodoc extension will handle index entries for the API, but additional
   entries in the index_ need to be explicitly added.
 
-.. _Sphinx: http://www.sphinx-doc.org
-.. _documentation: http://www.sphinx-doc.org/contents.html
-.. _`inline markup`: http://www.sphinx-doc.org/markup/inline.html
-.. _index: http://www.sphinx-doc.org/markup/para.html#index-generating-markup
-
 * Please limit the text width of docstrings to 70 characters.
 
 * Keyword arguments should be described using a definition list.
@@ -542,3 +537,9 @@ Some helpful functions::
         Shift region to the right
 
 .. TODO: Add section about uploading docs
+
+.. _Sphinx: http://www.sphinx-doc.org
+.. _documentation: http://www.sphinx-doc.org/contents.html
+.. _`inline markup`: http://www.sphinx-doc.org/markup/inline.html
+.. _index: http://www.sphinx-doc.org/markup/para.html#index-generating-markup
+.. _sphinx_gallery: https://sphinx-gallery.readthedocs.io/en/latest/
