Merge pull request #10875 from ipython/auto-backport-of-pr-10870

Backport PR  #10870 on branch 5.x

docs/source/sphinxext.rst

@@ -0,0 +1,8 b''
+========================
+IPython Sphinx extension
+========================
+
+IPython provides an extension for `Sphinx <http://www.sphinx-doc.org/>`_ to
+highlight and run code.
+
+.. automodule:: IPython.sphinxext.ipython_directive

IPython/sphinxext/ipython_directive.py

@@ -104,8 +104,8 b' or :okwarning: options:'
         In [1]: 1/0
         In [2]: # raise warning.
 
-ToDo
-----
+To Do
+-----
 
 - Turn the ad-hoc test() function into a real test suite.
 - Break up ipython-specific functionality from matplotlib stuff into better

docs/source/index.rst

@@ -93,6 +93,7 b' repository <http://github.com/ipython/ipython>`_.'
    development/index
    coredev/index
    api/index
+   sphinxext
    about/index
 
 .. seealso::