[Openstack-docs] Proposal: CLI Reference manual

Anne Gentle anne at openstack.org
Thu Jan 30 14:56:01 UTC 2014


On Thu, Jan 30, 2014 at 8:53 AM, Diane Fleming
<diane.fleming at rackspace.com>wrote:

> 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.
>
>
I can be convinced of this too -- and it's pretty much what we discussed at
the Hong Kong Summit. :) Thanks!
Anne


> 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
>
>
> _______________________________________________
> Openstack-docs mailing list
> Openstack-docs at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20140130/6a98f5b3/attachment-0001.html>


More information about the Openstack-docs mailing list