Add intersphinx section

dstansby · dstansby · commit 8fecdde38b6d · 2017-11-22T18:03:23.000Z
diff --git a/doc/devel/documenting_mpl.rst b/doc/devel/documenting_mpl.rst
@@ -139,6 +139,23 @@ An example docstring looks like:
 The Sphinx website also contains plenty of documentation_ concerning ReST
 markup and working with Sphinx in general.
 
+Linking to other code
+---------------------
+To link to other methods, classes, or modules in Matplotlib you can encase
+the name to refer to in back ticks, for example:
+
+.. code-block:: python
+
+  `~matplotlib.collections.LineCollection`
+
+It is also possible to add links to code in Python, Numpy, Scipy, or Pandas.
+Sometimes it is tricky to get external Sphinx linking to work; to check that
+a something exists to link to the following shell command outputs a list of all
+objects that can be referenced (in this case for Numpy)::
+
+  python -m sphinx.ext.intersphinx 'https://docs.scipy.org/doc/numpy/objects.inv'
+
+
 Function arguments
 ------------------
 Function arguments and keywords within docstrings should be referred to using
