On 08/09/2017 09:24 AM, Sean Dague wrote: > On 08/09/2017 09:19 AM, Doug Hellmann wrote: >> Excerpts from Sean Dague's message of 2017-08-08 17:01:29 -0400: >>> When trying to import >>> https://github.com/openstack/openstack-manuals/blob/6f9fc171800e8a435011f38cd4558e900884ce86/doc/config-reference/source/compute/hypervisor-vmware.rst#L2 >>> into the Nova admin config reference >>> (https://review.openstack.org/#/c/491853), a couple of interesting >>> challenges popped up. These pop up in a couple of other places, but this >>> one file nicely contains both of them. >>> >>> The first is the common autogenerated files (like >>> https://github.com/openstack/openstack-manuals/blob/6f9fc171800e8a435011f38cd4558e900884ce86/doc/config-reference/source/tables/nova-vmware.rst#L11). >>> To the best of my knowledge we don't have that autogeneration tooling in >>> the projects. Should we just be copy/pasting this content in? Is there >>> another better strategy there? >> >> oslo.config does have an extension for generating a table-format >> list of all of the configuration options, and the idea is to replace >> those included tables with the 'show-options' directive. It uses >> the same inputs as the sample file generator. See >> https://docs.openstack.org/oslo.config/latest/reference/sphinxext.html for >> details > > So in this case we could: > > .. show-options:: > > oslo.vmware > > > And that would have the same impact? I'm attempting to do this, and just getting: Warning, treated as error: Could not load oslo.vmware .tox/docs/bin/pip freeze shows that oslo.vmware is installed the tox env. Any ideas what I'm doing incorrectly? -Sean -- Sean Dague http://dague.net