[openstack-dev] [docs] Can we get the "configuration reference" of master more often?

Andreas Jaeger aj at suse.com
Thu Mar 3 14:51:07 UTC 2016

On 2016-03-03 15:37, Markus Zoeller wrote:
> 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?

The flagmappings file is manually updated - if a new option shows up, we
need to know to which table it should be added. Doug and Gauvain
discussed automating this in the future but this needs first some changes,


> 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)
> __________________________________________________________________________
> OpenStack Development Mailing List (not for usage questions)
> Unsubscribe: OpenStack-dev-request at lists.openstack.org?subject:unsubscribe
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev

 Andreas Jaeger aj@{suse.com,opensuse.org} Twitter: jaegerandi
  SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
   GF: Felix Imendörffer, Jane Smithard, Graham Norton,
       HRB 21284 (AG Nürnberg)
    GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1 389A 563C C272 A126

More information about the OpenStack-dev mailing list