Open Stack

----- Original Message -----
> From: "Andreas Jaeger" <aj at suse.com>
> To: "Diane Fleming" <diane.fleming at RACKSPACE.COM>, "Anne Gentle" <anne at openstack.org>
> Cc: openstack-docs at lists.openstack.org
> Sent: Friday, January 31, 2014 1:44:04 AM
> Subject: Re: [Openstack-docs] Proposal: CLI Reference manual
> 
> On 01/30/2014 04:26 PM, Diane Fleming wrote:
> > Actually, I'm fine either way – keeping it as appendix or as separate book.
> > 
> > But either way, I think we need to improve the formatting – I'll open a
> > bug for that.

And can the 'install the clients' section be removed? Clients should already be installed via the Installation Guide?

> 
> Yes, please do open a bug. I'll see what I can do to improve it.
> 
> > What does everyone else think about keeping command ref as appendix, or
> > moving to separate book?
> 
> I'm fine either way.  Having one more guide, will not really cost us
> more work than having it in the appendices. And having a guide would
> give us *one* location for the content instead of currently two guides
> with both the same large appendix.
Definitely vote for having it

> 
> And I'm even fine with removing the appendix and not having a book since
> these are help texts users could get themselves on the command line...
> Still, it's nice to have a common location to look it up and be aware of
> these. And since there are no man pages for these, this it probably the
> best way to have it,

+1 on removing the CLI info from both EUG and AUG and providing links (really dislike bloat-by-duplication).

But was there a reason for not just putting the CLI info into the Configuration Reference Guide?
We're removing the HowTos from that guide, which means the whole thing really is a reference now?


cheers, Summer
> 
> 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
> 

-- 
Summer Long 
OpenStack Documentation Lead 
Engineering Content Services 

Red Hat Asia Pacific 
Brisbane, Austral ia 
slong at redhat.com | irc: slong