[OpenStack-docs] how is cli-ref generated?
Kato, Tomoyuki
kato.tomoyuki at jp.fujitsu.com
Mon Sep 5 13:25:55 UTC 2016
> [snip]
>
> Duplication is a part of Akihiro's initial comment, and I think
> the the OSC shouldn't maintain it's own copy of this, but rather redirect
> to the docs page. I'd be more than happy to get rid of the OSC docs, before
> doing that I did a quick comparison between
> http://docs.openstack.org/cli-reference/openstack.html
> <http://docs.openstack.org/cli-reference/openstack.html> and
> http://docs.openstack.org/developer/python-openstackclient/command-lis
> t.html
> <http://docs.openstack.org/developer/python-openstackclient/command-li
> st.html>
>
>
> I don't agree with removing the docs from the OSC repo, we try to require
> docs updates in the same review as code changes, that will be impossible
> otherwise and the published docs will always lag. How will the docs.o.o
> version be maintained current?
>
> If there is something we can do to facilitate a periodic update of docs.o.o,
> I am all for it, be it on every commit or at release time (we release as-needed,
> not on the integrated cycle), which is my preference.
>
> Also note that our current RST docs contain more than just a one-for-one
> of the help output. It should contain MUCH more in the way of explanation.
>
> [snip]
I'd like to use the OSC repo for primarily document, too.
Thanks for taking up this issue.
Thanks,
KATO Tomoyuki
More information about the OpenStack-docs
mailing list