2016-07-23 18:04:04 -05:00
|
|
|
=======================
|
|
|
|
Cinder Development Docs
|
|
|
|
=======================
|
2012-05-03 10:48:26 -07:00
|
|
|
|
2016-07-23 18:04:04 -05:00
|
|
|
Files under this directory tree are used for generating the documentation
|
|
|
|
for the Cinder source code.
|
2012-05-03 10:48:26 -07:00
|
|
|
|
2016-07-23 18:04:04 -05:00
|
|
|
Developer documentation is built to:
|
2017-07-27 02:17:51 -07:00
|
|
|
https://docs.openstack.org/cinder/latest/
|
2012-05-03 10:48:26 -07:00
|
|
|
|
2016-07-23 18:04:04 -05:00
|
|
|
Tools
|
|
|
|
=====
|
2012-05-03 10:48:26 -07:00
|
|
|
|
2016-07-23 18:04:04 -05:00
|
|
|
Sphinx
|
|
|
|
The Python Sphinx package is used to generate the documentation output.
|
|
|
|
Information on Sphinx, including formatting information for RST source
|
2017-02-01 17:02:18 +01:00
|
|
|
files, can be found in the
|
|
|
|
`Sphinx online documentation <http://www.sphinx-doc.org/en/stable/>`_.
|
2012-05-03 10:48:26 -07:00
|
|
|
|
2016-07-23 18:04:04 -05:00
|
|
|
Graphviz
|
2012-05-03 10:48:26 -07:00
|
|
|
Some of the diagrams are generated using the ``dot`` language
|
2016-07-23 18:04:04 -05:00
|
|
|
from Graphviz. See the `Graphviz documentation <http://www.graphviz.org/>`_
|
|
|
|
for Graphviz and dot language usage information.
|
2012-05-03 10:48:26 -07:00
|
|
|
|
|
|
|
|
2016-07-23 18:04:04 -05:00
|
|
|
Building Documentation
|
|
|
|
======================
|
2012-05-03 10:48:26 -07:00
|
|
|
|
2016-07-23 18:04:04 -05:00
|
|
|
Doc builds are performed using tox with the ``docs`` target::
|
2015-03-17 15:17:02 +00:00
|
|
|
|
|
|
|
% cd ..
|
|
|
|
% tox -e docs
|
|
|
|
|