<div dir="ltr">Replying here on <a href="mailto:openstack-docs@lists.openstack.org">openstack-docs@lists.openstack.org</a> from a note (pasted below) that was sent to the docs-core list on Launchpad. We don't really use Launchpad mailing lists for communication, sorry about that. <br><br>---<br><br>Hi OpenStack documentation team, <br><br>Today’s OpenStack does not have doxygen integrated. I found no blueprints about integrating doxygen into OpenStack manuals.<br><br>Integrating doxygen will be very helpful for API users to understand the documentation, flow, call-graphs, classes, namespaces, files, functions, attributes (public / static), data structures, dependencies, etc in a pictorial way using a web browser. Once doxygen is integrated, all the code can be understood easily and fast in a web browser instead of manually figuring out in the code repository.<br><br>If new code, files, modules are added, there must a script that runs (as part of tempest, tox, or testr) doxygen and updates all the HTML files.<br><br>Please let me know if I can submit a draft blueprint for this request under the "openstack-manuals” project.<br><br>Please let me know your thoughts. Thanks a lot!<br><br>Regards, Vikram Hosakote OpenStack Software Engineer | <a href="mailto:vhosakot@cisco.com">vhosakot@cisco.com</a> Cloud and Virtualization Group | Cisco Systems Boxborough MA | Work : 978-936-8799<br><br><br>---<br><br>Thanks for asking. We definitely appreciate automation. Our primary focus for the official docs Program is end user (including app dev) and operator/admin docs right now. <br><br>Python docs for contributor devs is not really governed in the openstack-manuals blueprint area, but I know that Stefano Maffuli, our OpenStack community manager, is interested in improving contributor dev docs. Also I don't quite know how Doxygen would help API users (though perhaps you mean the internal APIs where of course it would help). <br><br>Stefano, can you think of a good place for this type of blueprint to land? Or team, do you envision a need to expand the doc program's scope to include this type of dev doc?<br><br>Be sure to come to the bootstrapping session this Friday 10/3 at 3:00 EST where we'll discuss dev docs. <a href="https://wiki.openstack.org/wiki/BootstrappingHour/Diving_Into_Docs">https://wiki.openstack.org/wiki/BootstrappingHour/Diving_Into_Docs</a><br>Thanks,<br>Anne<br></div>