Remove sections covered in sphinx docs

dstansby · dstansby · commit 265645e0f19d · 2017-11-19T21:43:33.000Z
diff --git a/doc/devel/documenting_mpl.rst b/doc/devel/documenting_mpl.rst
@@ -11,9 +11,9 @@ Installing dependencies
 -----------------------
 
 The documentation for Matplotlib is generated from reStructuredText using
-the Sphinx_ documentation generation tool.  There are several extra
-requirements that are needed to build the documentation.  They are listed in
-:file:`doc-requirements.txt` as well as listed below:
+the Sphinx_ documentation generation tool. There are several extra requirements
+that are needed to build the documentation. They are listed in
+:file:`doc-requirements.txt` and listed below:
 
 1. Sphinx 1.3 or later (1.5.0 is not supported)
 2. numpydoc 0.4 or later
@@ -45,33 +45,31 @@ Sphinx_.
    the directories :file:`docs/gallery` and :file:`docs/tutorials`
    are generated.
 
-The configuration file for Sphinx is :file:`doc/conf.py`.  It controls which
+The configuration file for Sphinx is :file:`doc/conf.py`. It controls which
 directories Sphinx parses, how the docs are built, and how the extensions are
 used.
 
 Building the docs
 -----------------
 
-The documentation sources are found in the :file:`doc/` directory in
-the trunk.  To build the documentation in html format, cd into
-:file:`doc/` and run:
+The documentation sources are found in the :file:`doc/` directory in the trunk.
+To build the documentation in html format, cd into :file:`doc/` and run:
 
 .. code-block:: sh
 
    python make.py html
 
-The list of comamnds and flags for ``make.py`` can be listed by running
-``python make.py --help``.  In particular,
+The list of commands and flags for ``make.py`` can be listed by running
+``python make.py --help``. In particular,
 
-* ``python make.py clean`` will delete the built Sphinx files.  Use this
-  command if you're getting strange errors about missing paths or broken links,
+* ``python make.py clean`` will delete the built Sphinx files. Use this command
+  if you're getting strange errors about missing paths or broken links,
   particularly if you move files around.
 * ``python make.py latex`` builds a PDF of the documentation.
 * The ``--allowsphinxwarnings`` flag allows the docs to continue building even
-  if Sphinx throws a warning.  This is useful for debugging and spot-checking
+  if Sphinx throws a warning. This is useful for debugging and spot-checking
   many warnings at once.
 
-
 Documentation organization
 ==========================
 
@@ -94,7 +92,7 @@ statement, such as::
 Formatting
 ==========
 
-Most documentaiton lives in "docstrings". These are comment blocks in the source
+Most documentation lives in "docstrings". These are comment blocks in the source
 code that explain how the code works. All new or edited docstrings should
 conform to the numpydoc guidelines. These split the docstring into a number
 of sections - see
@@ -139,8 +137,8 @@ An example docstring looks like:
         axhline: horizontal line across the axes
         """
 
-The Sphinx website contains plenty of documentation_ concerning ReST markup and
-working with Sphinx in general.
+The Sphinx website also contains plenty of documentation_ concerning ReST
+markup and working with Sphinx in general.
 
 Function arguments
 ------------------
@@ -165,58 +163,6 @@ nor the ````literal```` role:
 
    Please do not describe ``argument`` like this.
 
-Maths
------
-Mathematical expressions can be rendered as png images in html, and in the
-usual way by LaTeX. For example,
-
-.. code-block:: rst
-
-  :math:`\sin(x_n^2)`
-
-yields :math:`\sin(x_n^2)`, and:
-
-.. code-block:: rst
-
-   .. math::
-
-      \int_{-\infty}^{\infty}\frac{e^{i\phi}}{1+x^2\frac{e^{i\phi}}{1+x^2}}
-
-yields :math:`\int_{-\infty}^{\infty}\frac{e^{i\phi}}{1+x^2\frac{e^{i\phi}}{1+x^2}}`.
-
-IPython code
-------------
-Interactive IPython sessions can be illustrated in the documentation using
-the following directive:
-
-.. code-block:: rst
-
-  .. sourcecode-block:: ipython
-
-    In [69]: lines = plot([1,2,3])
-
-which yields
-
-.. code-block:: ipython
-
-  In [69]: lines = plot([1,2,3])
-
-Footnotes
----------
-Footnotes [#]_ can be added using ``[#]_``, followed later by:
-
-  .. code-block:: rst
-
-    .. rubric:: Footnotes
-
-    .. [#]
-
-which yields
-
-  .. rubric:: Footnotes
-
-  .. [#] For example.
-
 Figures
 =======
 
