The Sphinx website also contains plenty ofdocumentation_ 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

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)::

Function arguments

Function arguments and keywords within docstrings should be referred to using