[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