Andreas Jaeger 351bf3209b Prepare for translation of common files
Move imported files to common-rst directory so that we can share
translations with openstack-manuals.

Change-Id: I3f9be25579ae16550c32303117702d5500370b41
2015-07-23 19:12:35 +02: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.