<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Fri, Sep 2, 2016 at 5:13 AM, Andreas Jaeger <span dir="ltr"><<a href="mailto:aj@suse.com" target="_blank">aj@suse.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="">On 09/01/2016 11:30 PM, Steve Martinelli wrote:<br>
> cc'ed dtroyer (osc ptl)<br>
><br>
> Duplication is a part of Akihiro's initial comment, and I think the the<br>
> OSC shouldn't maintain it's own copy of this, but rather redirect to the<br>
> docs page. I'd be more than happy to get rid of the OSC docs, before<br>
> doing that I did a quick comparison between<br>
> <a href="http://docs.openstack.org/cli-reference/openstack.html" rel="noreferrer" target="_blank">http://docs.openstack.org/cli-<wbr>reference/openstack.html</a><br>
> and <a href="http://docs.openstack.org/developer/python-openstackclient/command-list.html" rel="noreferrer" target="_blank">http://docs.openstack.org/<wbr>developer/python-<wbr>openstackclient/command-list.<wbr>html</a><br>
><br>
> The only information that I see missing is that in the OSC docs we mark<br>
> some options (and commands) as being specific to an API version. For<br>
> instance, in "volume type create", the description, public, private, and<br>
> project options are only supported for the Volume V2 API (we (OSC) can't<br>
> do anything about this limitation). We document this limitation as such<br>
> here: <a href="http://docs.openstack.org/developer/python-openstackclient/command-objects/volume-type.html#volume-type-create" rel="noreferrer" target="_blank">http://docs.openstack.org/<wbr>developer/python-<wbr>openstackclient/command-<wbr>objects/volume-type.html#<wbr>volume-type-create</a><br>
> but it is not reflected<br>
> here: <a href="http://docs.openstack.org/cli-reference/openstack.html#openstack-volume-type-create" rel="noreferrer" target="_blank">http://docs.openstack.org/cli-<wbr>reference/openstack.html#<wbr>openstack-volume-type-create</a><br>
><br>
> If we can resolve this issue, then I think we can remove the docs from<br>
> OSCs page.<br>
<br>
</span>Alternative is to stop publishing the cli-guide - and publish only from<br>
osc. We could publish the documents from osc in a different place - or<br>
link to them differently,<br></blockquote><div><br></div><div>I agree with Dean's assessment and this is a great next project to move from central to distributed -- the CLI ref. I'd like to hear more from others but right now I like this direction.</div><div><br></div><div>Anne</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<br>
Andreas<br>
<span class="HOEnZb"><font color="#888888">--<br>
 Andreas Jaeger aj@{<a href="http://suse.com" rel="noreferrer" target="_blank">suse.com</a>,<a href="http://opensuse.org" rel="noreferrer" target="_blank">opensuse.org</a>} Twitter/Identica: jaegerandi<br>
  SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany<br>
   GF: Felix Imendörffer, Jane Smithard, Graham Norton,<br>
       HRB 21284 (AG Nürnberg)<br>
    GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126<br>
</font></span><div class="HOEnZb"><div class="h5"><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>
</div></div></blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature" data-smartmail="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div>Anne Gentle</div><div><a href="http://www.justwriteclick.com" style="font-size:12.8px" target="_blank">www.justwriteclick.com</a><br></div></div></div></div></div>
</div></div>