[OpenStack-docs] RST admin user guide

Andreas Jaeger aj at suse.com
Tue Apr 7 12:11:40 UTC 2015


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




More information about the OpenStack-docs mailing list