Documentation Logo

Demo documentation

The demo documentation provides example markup for looking at the expected output.

The project aims for simple implementation, massive scalability, and a rich set of features. Cloud computing experts from around the world contribute to the project.


Here’s an example glossary:


An OpenStack grouped release of projects that came out in the spring of 2011. It included Compute (nova), Object Storage (swift), and the Image service (glance). Cactus is a city in Texas, US and is the code name for the third release of OpenStack. When OpenStack releases went from three to six months long, the code name of the release changed to match a geography nearest the previous summit.


Cloud Auditing Data Federation (CADF) is a specification for audit event data. CADF is supported by OpenStack Identity.


One of the RPC primitives used by the OpenStack message queue software. Sends a message and waits for a response.

Literal Blocks

Here’s an example configuration:

my_ip =
vnc_enabled = True
vncserver_listen =
vncserver_proxyclient_address =
novncproxy_base_url = http://controller:6080/vnc_auto.html

Code Blocks

Here’s another example that’s python code:

 1def builder_inited(app):
 2    theme_dir = os.path.join(os.path.dirname(__file__), 'theme')
 3'Using openstack theme from %s' % theme_dir)
 4    # Insert our theme directory at the front of the search path and
 5    # force the theme setting to use the one in the package. This is
 6    # done here, instead of in setup(), because is read after
 7    # setup() runs, so if the conf contains these values the user
 8    # values overwrite these. That's not bad for the theme, but it
 9    # breaks the search path.
10    app.config.html_theme_path.insert(0, theme_dir)
11    # Set the theme name
12    app.config.html_theme = 'openstack'
13    # Re-initialize the builder, if it has the method for setting up
14    # the templates and theme.
15    if hasattr(app.builder, 'init_templates'):
16        app.builder.init_templates()

Here’s the same example but with ..code-block: ini to test the pygments lexer:

my_ip =
vnc_enabled = True
vncserver_listen =
vncserver_proxyclient_address =
novncproxy_base_url = http://controller:6080/vnc_auto.html


Here’s a sample table:

OpenStack projects






To implement services and associated libraries to provide massively scalable, on demand, self service access to compute resources, including bare metal, virtual machines, and containers.



OpenStack Neutron is an SDN networking project focused on delivering networking-as-a-service (NaaS) in virtual compute environments.


Object store

Swift is a highly available, distributed, eventually consistent object/blob store. Organizations can use Swift to store lots of data efficiently, safely, and cheaply. It’s built for scale and optimized for durability, availability, and concurrency across the entire data set. Swift is ideal for storing unstructured data that can grow without bound.


Notices take these forms.



A comment with additional information that explains a part of the text.



Something you must be aware of before proceeding.



An extra but helpful piece of practical advice.



Helpful information that prevents the user from making mistakes.


See also

A reference to another piece of related information, like a related setting or upstream documentation



Critical information about the risk of data loss or security issues.

Configuration addition and deprecation notices

New in version 9.0.0-Mitaka.

New in version 10.0.0-Newton.

Changed in version 10.0.0-Newton: Added support for new tags!

Changed in version 11.0.0-Ocata: Showing that multiple notices work!

Deprecated since version 11.0.0-Ocata: Use Notices instead.

Deprecated since version 12.0.0-Pike: A second deprecation notice