*:: 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}