[OpenStack-docs] RST admin user guide

Anne Gentle annegentle at justwriteclick.com
Tue Apr 7 02:50:28 UTC 2015


On Mon, Apr 6, 2015 at 6:45 PM, Karen Bradshaw <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





>
> _______________________________________________
> 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/20150406/b249869a/attachment.html>


More information about the OpenStack-docs mailing list