<div dir="ltr">for reference, the help that the docs team publishes is here: <a href="http://docs.openstack.org/cli-reference/openstack.html">http://docs.openstack.org/cli-reference/openstack.html</a><div><br></div><div>and the one that the OSC team publishes is here: <a href="http://docs.openstack.org/developer/python-openstackclient/command-list.html">http://docs.openstack.org/developer/python-openstackclient/command-list.html</a></div><div><br></div><div>I was under the impression that the first one (published by the docs team) was done with automation</div></div><div class="gmail_extra"><br><div class="gmail_quote">On Wed, Aug 31, 2016 at 1:36 PM, Akihiro Motoki <span dir="ltr"><<a href="mailto:amotoki@gmail.com" target="_blank">amotoki@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hi,<br>
<br>
I wonder how CLI reference is generated?<br>
I looked for some document on the process of the CLI reference but I<br>
failed to find it.<br>
<br>
This question mainly comes from the following two.<br>
<br>
(1) Why the process is not automated?<br>
I see a lot of patches to CLI reference when new version of CLIs are release.<br>
I wonder why they are not automated.<br>
<br>
(2) Duplicated information on OSC<br>
OSC provides useful and detail command line help in their devref.<br>
OSC CLI reference in openstack-manuals looks like a duplicated effort.<br>
If the docs team has not talked with OSC team, it means a lack of<br>
communications.<br>
<br>
Anyway, I think we should try and explore more automated way<br>
rather than spend time to keep them up-to-date manually.<br>
<br>
Thought?<br>
<br>
Thanks,<br>
Akihiro<br>
<br>
______________________________<wbr>_________________<br>
OpenStack-docs mailing list<br>
<a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.<wbr>openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" rel="noreferrer" target="_blank">http://lists.openstack.org/<wbr>cgi-bin/mailman/listinfo/<wbr>openstack-docs</a><br>
</blockquote></div><br></div>