Launchpad blueprint:
https://blueprints.launchpad.net/openstack-manuals/+spec/manila-config-ref
Shared File Systems (manila) should be added to the Config Ref similar to Block Storage (cinder).
Shared File Systems (manila) is not currently included in the Configuration Reference. The documentation is currently kept in-tree in the manila devref. Administrators using Block Storage, Object Storage, and Shared File Systems would expect to find a similar reference for all three projects in the Configuration Reference. The automated configuration doc tools should be leveraged.
The content would be similar to Block Storage in that it would have sections to describe introduction, drivers, log files, and options. The drivers section, however, would use shorter more stable descriptions of drivers and use links to vendor web sites and in-tree vendor docs.
Automatically generated configuration tables should be used where possible.
The amount of vendor driver documentation that should be included in the Configuration Reference is up for discussion. The current direction suggests using links to other docs for things that change from release to release. For Shared File Systems, we could use links to the existing devref. The devref is easy for developers to maintain in-tree. So, that is good for technical details. Unfortunately the reading experience will suffer if we don’t keep “the right amount” of information in the Configuration Reference. So we’ll need to work on finding that right amount.
Review by the manila core team and contributors.
Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.