d0e31ca6e1
The tox/Sphinx job does not use this makefile and the README refers to some unrelated/cookiecutter information. TrivialFix Change-Id: Ic9dc7818dd5f0e2a6d2f691046f6c1fb30cf0cd0 Co-Authored-By: Sean McGinnis <sean_mcginnis@dell.com>
34 lines
867 B
ReStructuredText
34 lines
867 B
ReStructuredText
=======================
|
|
Manila Development Docs
|
|
=======================
|
|
|
|
Files under this directory tree are used for generating the documentation
|
|
for the manila source code.
|
|
|
|
Developer documentation is built to:
|
|
http://docs.openstack.org/developer/manila/
|
|
|
|
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
|
|
<http://www.sphinx-doc.org/en/stable/>`_.
|
|
|
|
Graphviz
|
|
Some of the diagrams are generated using the ``dot`` language
|
|
from Graphviz. See the `Graphviz documentation <http://www.graphviz.org/>`_
|
|
for Graphviz and dot language usage information.
|
|
|
|
|
|
Building Documentation
|
|
======================
|
|
|
|
Doc builds are performed using tox with the ``docs`` target::
|
|
|
|
% cd ..
|
|
% tox -e docs
|
|
|