<div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">On Thu, Jan 30, 2014 at 8:35 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"><div class="im">On 01/29/2014 08:31 PM, Andreas Jaeger wrote:<br>
> As discussed in today's IRC meeting and as a followup to the Hongkong<br>
> summit (see [1]), I've drafted a CLI Reference.<br>
><br>
> Patch is available here:<br>
> <a href="https://review.openstack.org/#/c/69942/" target="_blank">https://review.openstack.org/#/c/69942/</a><br>
><br>
> A complete manual is published for review at:<br>
> <a href="http://users.suse.com/~aj/cli-reference/content" target="_blank">http://users.suse.com/~aj/cli-reference/content</a><br>
<br>
</div>So, the question is: Is this the right way forward:<br>
<br>
* Do we want to have the guide as proposed at all?<br>
<br>
* What needs to be done to make it better?<br>
<br>
* Should we remove the appendices from the End User Guide and the Admin<br>
User Guide that contain the same content (and add appropriate pointers<br>
to the book)?<br></blockquote><div><br></div><div>Thanks for setting it up, somehow it really helped me.</div><div>Looking at a 200-page separate book, even though it's fairly simple to maintain, it seems like it fits better in the End User Guide. Then again it means 170+ extra pages in both the End User Guide and Admin Guide, so I can be convinced either way (appendix or separate book). Right now I'm leaning towards keeping it as an appendix and continuously publishing it with the End User Guide. </div>

<div><br></div><div>I think that users tend to install the CLI via pip install (that's what we see at Rackspace and I've also talked to private cloud users). So to me, they install any given day, not just from a packaged version. </div>

<div><br></div><div>Hope to hear more from others. </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>
* Is this really a continuously publishing book? Since the libraries are<br>
continuously published, I suggest that we have it only one version (so<br>
no havana/icehouse etc version).<br>
<span class="HOEnZb"><font color="#888888"><br>
Andreas<br>
--<br>
 Andreas Jaeger aj@{<a href="http://suse.com" target="_blank">suse.com</a>,<a href="http://opensuse.org" target="_blank">opensuse.org</a>} Twitter: jaegerandi<br>
</font></span><div class="HOEnZb"><div class="h5">  SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany<br>
   GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg)<br>
    GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126<br>
<br>
_______________________________________________<br>
Openstack-docs mailing list<br>
<a href="mailto:Openstack-docs@lists.openstack.org">Openstack-docs@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
</div></div></blockquote></div><br></div></div>