On Thu, Mar 3, 2016 at 8:37 AM, Markus Zoeller <mzoel...@de.ibm.com> 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?
>

Yes. The necessity of a human running that tool and creating a patch.

Would love help automating, of course!

Thanks,
Anne


>
> 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-requ...@lists.openstack.org?subject:unsubscribe
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
>



-- 
Anne Gentle
Rackspace
Principal Engineer
www.justwriteclick.com
__________________________________________________________________________
OpenStack Development Mailing List (not for usage questions)
Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev

Reply via email to