mirror of
https://github.com/python/cpython.git
synced 2025-10-21 06:02:21 +00:00
582c0a6ac2
svn+ssh://pythondev@svn.python.org/python/trunk ........ r80388 | georg.brandl | 2010-04-23 00:15:33 +0200 (Fr, 23 Apr 2010) | 1 line Add "report a bug" links in some prominent places. Make it clear that doc bugs can be mailed to docs@python.org. Clarify tracker usage. ........
37 lines
1.1 KiB
ReStructuredText
37 lines
1.1 KiB
ReStructuredText
.. _documenting-index:
|
|
|
|
######################
|
|
Documenting Python
|
|
######################
|
|
|
|
|
|
The Python language has a substantial body of documentation, much of it
|
|
contributed by various authors. The markup used for the Python documentation is
|
|
`reStructuredText`_, developed by the `docutils`_ project, amended by custom
|
|
directives and using a toolset named `Sphinx`_ to postprocess the HTML output.
|
|
|
|
This document describes the style guide for our documentation, the custom
|
|
reStructuredText markup introduced to support Python documentation and how it
|
|
should be used, as well as the Sphinx build system.
|
|
|
|
.. _reStructuredText: http://docutils.sf.net/rst.html
|
|
.. _docutils: http://docutils.sf.net/
|
|
.. _Sphinx: http://sphinx.pocoo.org/
|
|
|
|
.. note::
|
|
|
|
If you're interested in contributing to Python's documentation, there's no
|
|
need to write reStructuredText if you're not so inclined; plain text
|
|
contributions are more than welcome as well. Send an e-mail to
|
|
docs@python.org or open an issue on the :ref:`tracker <reporting-bugs>`.
|
|
|
|
|
|
.. toctree::
|
|
:numbered:
|
|
:maxdepth: 1
|
|
|
|
intro.rst
|
|
style.rst
|
|
rest.rst
|
|
markup.rst
|
|
fromlatex.rst
|