openstack/deb-mistral
Code Issues Proposed changes
f34edb7e27
deb-mistral/doc
History
Nikolay Mahotkin caa2045ed1 Adjust docs API to last changes 
* Added Action Executions
 * Added Environments
 * Deleted DSLv1 doc
 * Minor changes

Change-Id: I52cd6acc9f786cf2dac03cb7ab9465bc4f34f365
2015-05-12 13:35:31 +03:00
..
source Adjust docs API to last changes 2015-05-12 13:35:31 +03:00
README.md Add documentation - part 3 2014-10-16 20:45:39 -07:00

README.md

Sphinx DOC hints

Migrating from Openstack Wiki

  • Install pandoc

  • Copy wiki code into a file, e.g. source.mw

  • Convert to .rst

    pandoc --from=mediawiki --to=rst --output=doc/source/dsl/dsl_v1.rst doc/source/dsl/source.mw

  • To make code samples fancy:

    TODO: figure how to make YAML samples look nicer with code:: directive

Using autodoc with sphinxcontrib.pecanwsme.rest and wsmeext.sphinxext plugins

TODO: why REST URL is not generated with parameters?

Running sphinx-audobuild

auto-loader - rules for convenient development https://pypi.python.org/pypi/sphinx-autobuild/0.2.3. install, and run:

sphinx-autobuild doc/source doc/build