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

Anne Gentle annegentle at justwriteclick.com
Thu Mar 3 14:44:31 UTC 2016


On Thu, Mar 3, 2016 at 8:37 AM, Markus Zoeller <mzoeller at 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-request at lists.openstack.org?subject:unsubscribe
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
>



-- 
Anne Gentle
Rackspace
Principal Engineer
www.justwriteclick.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20160303/e5529ae9/attachment.html>


More information about the OpenStack-dev mailing list