[DOC] Missing ability to automatically build configuration reference artifacts

[Goutham Pacha Ravi]

When the configuration reference was part of the OpenStack Manuals project, the scripts to automatically parse configuration options in manila and diff them to produce options that changed between releases were handled by the docs teams. Now that all projects have moved their documentation in-tree, the scripts to produce manila config documentation automatically, including rendering a release diff for these options (like https://docs.openstack.org/ocata/config-reference/tables/conf-changes/manila.html) may need to be maintained by the project.

In Pike, we currently lack a release diff of the configuration options like there was for Ocata, https://docs.openstack.org/ocata/config-reference/tables/conf-changes/manila.html

[Ben Swartzlander (bswartz)]

See related nodes from Cinder PTG:

https://etherpad.openstack.org/p/cinder-ptg-queens-wednesday-notes

[Ben Swartzlander (bswartz)]

Example of how Nova is doing it:

https://github.com/openstack/nova/commit/83a9c2ac334712b27704a814552628cf0e536a85

[Ben Swartzlander (bswartz)]

Relevant link:
https://docs.openstack.org/oslo.config/latest/reference/sphinxext.html

[Ashley Rodriguez (ashrod98)]

Stal Bug Triage: This bug is still valid, fix pending.

[Vida Haririan (vhariria)]

Additional comments at https://meetings.opendev.org/meetings/manila/2022/manila.2022-10-13-15.00.log.html

[Vida Haririan (vhariria)]

See additional triage information at https://meetings.opendev.org/meetings/manila/2024/manila.2024-02-29-15.00.log.html