[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,

Andreas

> 
> 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