[openstack-dev] [oslo][nova] Anyone interested in writing a policy generator sphinx extension?

Matt Riedemann mriedem at linux.vnet.ibm.com
Wed Sep 21 14:49:29 UTC 2016


Nova has policy defaults in code now and we can generate the sample 
using oslopolicy-sample-generator but we'd like to get the default 
policy sample in the Nova developer documentation also, like we have for 
nova.conf.sample.

I see we use the sphinxconfiggen extension for building the 
nova.conf.sample in our docs, but I don't see anything like that for 
generating docs for a sample policy file.

Has anyone already started working on that, or is interested in working 
on that? I've never written a sphinx extension before but I'm guessing 
it could be borrowed a bit from how sphinxconfiggen was written in 
oslo.config.

-- 

Thanks,

Matt Riedemann




More information about the OpenStack-dev mailing list