524ad986e3
The manila discussed cephfs futures during the Victoria cycle PTG [1]. To support newer features in ceph, we'll need to start using the ceph-mgr interface that debuted in Nautilus. When we start adopting ceph-mgr, we can no longer support Mimic, Luminous and older releases of Ceph without maintaining code workarounds and a continuous integration system to ensure they're not broken. This takes considerable effort from community members. We've supported the Luminous release since OpenStack Queens, and there have been at least three other major releases of Ceph in the meantime, let's add a release note and adjust the ceph driver documentation calling out our support/testing stance. [1] http://lists.openstack.org/pipermail/openstack-discuss/2020-June/015494.html Partially-implements: bp update-cephfs-drivers Change-Id: Id847b1b5e6623172f2600afd69e51182067444cb Signed-off-by: Goutham Pacha Ravi <gouthampravi@gmail.com>
Manila Development Docs
Files under this directory tree are used for generating the documentation for the manila source code.
Developer documentation is built to: https://docs.openstack.org/manila/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
dotlanguage 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