The "configuration reference" manual at [1] is really helpful to get
an overview of the options and we (Nova folks) were wondering if we
could have that updated more often [2].
Right now it is from November 2015 [3] and we (Nova folks) put a lot of
effort this cycle in improving the help of our config options but they
aren't yet (fully) reflected in that guide.
Different options would be:
A: per milestone
B: per merge of a commit which contains "DocImpact" in its message
C: daily/nightly
Personally I think daily/nightly would be sufficient.
AFAIK the generation of that guide is done with [4] and IIUC there is
no necessity of human intervention in that process, or did I miss
something?
References:
[1]
http://docs.openstack.org/draft/config-reference/compute/config-options.html
[2]
http://eavesdrop.openstack.org/irclogs/%23openstack-nova/%23openstack-nova.2016-03-03.log.html#t2016-03-03T13:40:15
[3]
http://eavesdrop.openstack.org/irclogs/%23openstack-doc/%23openstack-doc.2016-03-03.log.html#t2016-03-03T13:51:15
[4]
https://github.com/openstack/openstack-doc-tools/tree/master/autogenerate_config_docs
Regards, Markus Zoeller (markus_z)