
Castellan commit 8980bf7da55dd084ad84c84534fe937f0d43b9c0 deprecated the api_class option in favor of the new backend option. This causes doc build failures in Cinder due to us treating warnings as errors. This changes over to use backend (the library will still recognize api_class as an option) and removed some of the key manager code deprecated in Newton. Depends-on: I112f7a4654a65c3291526b408838d7b1c175b069 Closes-bug: #1718468 Change-Id: I8d3638a69f4efcc52053269c51c01667fb810172
Cinder Development Docs
Files under this directory tree are used for generating the documentation for the Cinder source code.
Developer documentation is built to: https://docs.openstack.org/cinder/latest/
Tools
- Sphinx
-
The Python Sphinx package is used to generate the documentation output. Information on Sphinx, including formatting information for RST source files, can be found in the Sphinx online documentation.
- Graphviz
-
Some of the diagrams are generated using the
dot
language from Graphviz. See the Graphviz documentation for Graphviz and dot language usage information.
Building Documentation
Doc builds are performed using tox with the docs
target:
% cd ..
% tox -e docs