Page History

The following products are used in the maintenance of the documentation:

Source Git Repository

Consolidated Documentation can be found in GitHub here:

https://github.com/apache/cloudstack-documentation/

The older documentation sources are held in git.as archived source in GitHub here:

https://github.com/apache/cloudstack-docs.git is a bit of a dodge-podge of resources
https://github.com/apache/cloudstack-docs-install.git is the install guide
https://github.com/apache/cloudstack-docs-admin.git is the current admin manual.
https://github.com/apache/cloudstack-docs-rn.git is the release notes for individual releasesA plan to consolidate the install and admin guides has been created but not worked on.

Sphinx

httphttps://github.com/apachecloudstack/consolidated-documentation.git is the new consolidated documentationwww.sphinx-doc.org/en/master/index.html

The documentation is uses Sphinx, which provides the structure and hierarchy of the documentation. It is the engine which renders the source text into HTML, PDF and ePub formats.  You can install and use Sphinx to build the documentation to see what it will look like before pushing a change, but it isn't required.

Read The Docs

https://readthedocs.org

The CloudStack documentation is built with using the ReadTheDocs service. ReadTheDocs takes the source text and runs it through the Sphinx engine to produce the documentation and also hosts the output.  Access is not strictly required in order to write/update the source documentation. Only to build the documentation for a new version.

...

This is the authoring language that is used while write individual topics.  reStructured text (RST) is the markup language that allows us to denote, headings, sections, bullets, bold text, italics etc.

• QuickStart Manual
• Home Page

Here are some great resources to get started with reStructured text in a Sphinx context  

• http://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html
• http://documentation-style-guide-sphinx.readthedocs.io/en/latest/style-guide.html

Rest Editor for Eclipse

This is the plug-in that supports the maintenance and production of documents in Eclipse.

...