*:: To make edits to the latest version, make your changes on the *master* branch. *:: To make edits to the stable version, make your changes to the *V8_8-branch* (or the appropriate *V8_8_X-branch* if making your changes after code freeze) +{section: Editing} + +The manual now uses the reStructuredText (rST) format, which is similar to Markdown markup but considerably more powerful. A helpful reference to reStructuredText is available here: + +http://docutils.sourceforge.net/docs/user/rst/quickref.html + +In addition, the new manual also uses the Sphinx documentation generator. Sphinx does many useful things such as: + +*:: Converts reStructuredText files into HTML websites, PDF, EPUB and man pages. +*:: Extends rST to provide more complex inline widgets such as tables of contents, syntax-colored code blocks, internal links and references, +*:: Automatic indices, search and language-specific module indices +*:: Provides a powerful API for writing custom extensions + +A full Sphinx reference is available here: + +http://www.sphinx-doc.org/en/master/contents.html + +This section provides some markup style guidelines, as well as information about how we use both built-in and custom tools. + + + {section: Publishing} {subsection: Publishing the manual onto Read the Docs}