rest25/documenting/index.rst => rest262/documenting/index.rst
3######################
4  Documenting Python
5######################
6
7
8The Python language has a substantial body of documentation, much of it
9contributed by various authors. The markup used for the Python documentation is
10`reStructuredText`_, developed by the `docutils`_ project, amended by custom
n11-directives and using a toolset named *Sphinx* to postprocess the HTML output.
n11+directives and using a toolset named `Sphinx`_ to postprocess the HTML output.
12
13This document describes the style guide for our documentation, the custom
14reStructuredText markup introduced to support Python documentation and how it
15should be used, as well as the Sphinx build system.
16
17.. _reStructuredText: http://docutils.sf.net/rst.html
18.. _docutils: http://docutils.sf.net/
n19+.. _Sphinx: http://sphinx.pocoo.org/
19
20If you're interested in contributing to Python's documentation, there's no need
21to write reStructuredText if you're not so inclined; plain text contributions
22are more than welcome as well.
23
24.. toctree::
n26+   :numbered:
25
26   intro.rst
27   style.rst
28   rest.rst
29   markup.rst
t30-   sphinx.rst
t32+   fromlatex.rst
31- 
32-.. XXX add credits, thanks etc.
33- 
Legends
Colors
 Added 
Changed
Deleted
Links
(f)irst change
(n)ext change
(t)op