Open Stack

Andreas, 

After looking at the new CLI reference, I'm okay with having it as a
separate book and removing the appendices from the End User Guide and
Admin User Guide.

However, I do think we could do more work to improve the formatting of the
Command Reference - I can suggest a format for the output. That will
involve more coding work, but I think it would be worth it.

However, for the time being, this is still a huge improvement, so I think
we should push through the current version.

The enhanced command reference is 200 pages, so it's probably best to
remove it from the user guides, and provide pointers from those guides to
the new Command Reference.

So I recommend:

1. Update Command Reference to use same ch_cli.xml file as End User Guide,
with conditions to omit unneeded content.
   Then, push through current version of Command Reference. One version
(trunk), and no release-centric versions.
2. Remove appendices from user guides, and include pointers to new Command
Reference. However, leave the ch_cli.xml as is in both those books.
   (Don't remove installation    instructions for CLIs.)
3. New bug to improve formatting in Command Reference.

My two cents!


Diane
----------------------------------------------
Diane Fleming
Software Developer II - US

diane.fleming at rackspace.com
Cell  512.323.6799
Office 512.874.1260
Skype drfleming0227
Google-plus diane.fleming at gmail.com






On 1/30/14 8:35 AM, "Andreas Jaeger" <aj at suse.com> wrote:

>On 01/29/2014 08:31 PM, Andreas Jaeger wrote:
>> As discussed in today's IRC meeting and as a followup to the Hongkong
>> summit (see [1]), I've drafted a CLI Reference.
>> 
>> Patch is available here:
>> https://review.openstack.org/#/c/69942/
>> 
>> A complete manual is published for review at:
>> http://users.suse.com/~aj/cli-reference/content
>
>So, the question is: Is this the right way forward:
>
>* Do we want to have the guide as proposed at all?
>
>* What needs to be done to make it better?
>
>* Should we remove the appendices from the End User Guide and the Admin
>User Guide that contain the same content (and add appropriate pointers
>to the book)?
>
>* Is this really a continuously publishing book? Since the libraries are
>continuously published, I suggest that we have it only one version (so
>no havana/icehouse etc version).
>
>Andreas
>-- 
> Andreas Jaeger aj@{suse.com,opensuse.org} Twitter: jaegerandi
>  SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
>   GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg)
>    GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126
>
>_______________________________________________
>Openstack-docs mailing list
>Openstack-docs at lists.openstack.org
>http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs