Shilla Saebi 44136cbf5b cleanup source doc files for api-site
reproducable to reproducible
maintanance to maintenance
concerened to concerned
intrinsicly to intrinsically
specifed to specified
priniciples to principles
applicaiton to application
throughsome to through some
attibute to attribute

Change-Id: I664a7b7476fbeafcde514fa63f42524d91e0c56a
2015-05-28 18:48:35 -04:00
..

Writing your First OpenStack Application

This directory contains the "Writing your First OpenStack Application" tutorial.

The tutorials works with an application that can be found at: https://github.com/stackforge/faafo

/source

The /source directory contains a playground for the actual tutorial documentation. It's reStructuredText (RST), built with Sphinx.

The RST source includes conditional output logic, so specifying:

tox -e firstapp-libcloud

will invoke sphinx-build with -t libcloud, meaning sections marked .. only:: libcloud in the RST will be built, while others won't.

Sphinx and the OpenStack docs.openstack.org Sphinx Theme (openstackdocstheme) are needed to build the docs.

/samples

The code samples provided in the guide are sourced from files in this directory. There is a sub-directory for each SDK.