[OpenStack-docs] RST admin user guide

Anne Gentle annegentle at justwriteclick.com
Tue Apr 7 18:17:47 UTC 2015


On Tue, Apr 7, 2015 at 1:12 PM, Laurel Michaels <lmichaels at tesora.com>
wrote:

> I know this thread started with the admin user guide, but the bug that
> Anne created mentions the end user guide too, so here is a question about
> the end user guide.
>
> End User Guide -- in the dashboard, the section called "Create and manage
> databases" is missing the last topic, which is "Update a database instance"
>
> Old docbook page:
>
>
> http://docs.openstack.org/user-guide/content/dashboard_databases.html#dashboard_update_db
>
>
> New RST page:
>
>
> http://docs-draft.openstack.org/34/170734/4/check/gate-openstack-manuals-tox-doc-publish-checkbuild/f15fa3e//publish-docs/draft/user-guide/content/enduser/dashboard_databases.html
>
> I know why this happened -- the update section got added at the same time
> the RST version was being created.
>
> I can add the update section to the RST.
>
>
Thank you!



> Question -- I know there are several people working on this bug
> simultaneously -- do I have to/should I assign the bug to me or should I
> not do that? Can I submit a Partial-Bug: #1440957 if the bug is not
> assigned to me?
>

Yep, and the system automatically assigns whoever "last" updated the patch
that has the Partial-bug: nnnnnn in it. It's magical. :)


>
> Sorry, just my ignorance speaking here :)
>
>
Just inexperience, not ignorance. :) Great question.

Anne


> Thanks,
>
> Laurel
>
>
> ________________________________________
> From: Andreas Jaeger <aj at suse.com>
> Sent: Tuesday, April 7, 2015 8:11 AM
> To: Anne Gentle; Karen Bradshaw
> Cc: openstack-docs at lists.openstack.org
> Subject: Re: [OpenStack-docs] RST admin user guide
>
> On 04/07/2015 04:50 AM, Anne Gentle wrote:
> >
> >
> > On Mon, Apr 6, 2015 at 6:45 PM, Karen Bradshaw <kbhawkey at gmail.com
> > <mailto:kbhawkey at gmail.com>> wrote:
> >
> >     Reading through the generated admin user guide, here is what I found
> >     so far:
> >     I am basing my findings on the files generated from my local build
> to,
> >     user-guides/build-admin/html/index.html
> >
> >     1.  First content item, How can I administer ...
> >     The topics "cURL" and "horizon" should be active links to html pages?
> >     2.  In the Dashboard, missing "Manage projects and users",
> >     missing "Manage volumes and volume types".   "manage instances"
> should
> >     be before "manage images" in the dashboard list.
> >     3.  There are formatting/markup errors in "Create and manage host
> >     aggregates" page. See the words "Procedure" and "Scheduling".
> >     4.  The dashboard's first paragraph has been updated.  Is this
> correct?
> >     OLD:  As a cloud administrative user, the OpenStack dashboard lets
> >     you create and manage projects, users, images, and flavors. You can
> >     also set quotas and create and manage services. For information
> >     about using the dashboard to perform end user tasks, see the
> >     /OpenStack End User Guide
> >     <http://docs.openstack.org/user-guide/content/>/
> >
> >     NEW: As a cloud end user, you can use the OpenStack dashboard to
> >     provision your own resources within the limits set by
> >     administrators. You can modify the examples provided in this section
> >     to create other types and sizes of server instances.
> >
> >
> >
> > Thanks Karen! Let's start tracking these with a doc bug in
> > openstack-manuals:
> > https://bugs.launchpad.net/openstack-manuals/+bug/1440957
> >
> > Then we can put Partial-bug: 1440957 in the commit messages for patches
> > that address these.
> >
> > To answer the question 4, I think that "OLD" one was the original text
> > for the Admin User Guide, and should be reversed (OLD goes with admin,
> > NEW goes with End User).
> >
> > I've tried to address 2 with this patch:
> > https://review.openstack.org/#/c/171025/ which also adds the missing
> > config drive page.
> >
> > Thanks for the great eyes! I need a fresh pair after all the
> > side-by-side comparisons!
> > Anne
>
> Thanks Karen for spotting these!
>
> Issue number 4 addressed with:
> https://review.openstack.org/171150
>
> Andreas
> --
>   Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
>    SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
>     GF: Felix Imendörffer, Jane Smithard, Jennifer Guild, Dilip Upmanyu,
>         Graham Norton, HRB 21284 (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
>



-- 
Anne Gentle
annegentle at justwriteclick.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20150407/d9ca400e/attachment.html>


More information about the OpenStack-docs mailing list