Open Stack

Oh we don't have to use those names in the actual metadata in the book. I
was just making sure we're using personas recognized in the rest of the
community.

The audience statement is more like "Who this Book is For" in the Ops Guide:

http://docs.openstack.org/trunk/openstack-ops/content/openstack-ops_preface.html#who-this-book-is-for


On Tue, May 20, 2014 at 2:36 AM, Andreas Jaeger <aj at suse.com> wrote:

> On 05/20/2014 07:18 AM, Anne Gentle wrote:
> > Thanks for analyzing Andreas and Randy!
> >
> > I like these three simple personas below.
> >
> > Alice the admin
> > Alice is an administrator who is responsible for maintaining (and
> > securing) the OpenStack cloud installation. She has many years of
> > experience with Linux systems administration.
> >
> > Darren the deployer
> > Darren is responsible for doing the initial OpenStack deployment on the
> > host machines.
> > Emile the end-user
> > Emile uses the cloud to do software development inside of the virtual
> > machines. She uses the command-line tools because she finds it quicker
> > than using the dashboard.
>
> Yes, these are fine - but let's rename Alice since Alice and Bob are the
> two persons used in the Security Guide explaining the two different setups.
>
> > To me, Emile is a useful persona because she uses user tools and
> > developer tools -- and I do see a lot of blending across user/dev tools.
> > Andreas, the user we haven't yet started to document for is the
> > application devops role, the operator who would monitor applications in
> > the cloud. They might be super specialized for monitoring of the VMs
> > themselves.
> >
> > But I'm not sure whether there's a fourth persona who does planning and
> > setup, what do you all think? Archie the architect?
>
> So, the OPS guide would be for Archie?
>
> > We also don't have to be super pattern-based, we can just write a
> > section describing the audience for each guide.
>
> ;)
>
> Andreas
>
> >
> > On Mon, May 19, 2014 at 3:41 PM, Andreas Jaeger <aj at suse.com
> > <mailto:aj at suse.com>> wrote:
> >
> >     We had some discussion about target audience for each guide at the
> >     OpenStack summit and Anne filed this bug:
> >     https://bugs.launchpad.net/openstack-manuals/+bug/1319394 . As a
> first
> >     step, I've went over all guides and categorized them according to
> target
> >     audience and then copied all the current abstracts together. Is the
> >     following accurate?
> >
> >     Andreas
> >
> >     Overview of personas/target audience:
> >
> >     Operations Guide
> >     Cloud Administrator Guide
> >     Configuration Reference
> >     HA Guide
> >     Install Guide
> >     Security Guide
> >     Admin User Guide
> >
> >     These guides target cloud administrators who sets up an OpenStack
> >     cloud and configures the OpenStack services.
> >
> >     End User Guide
> >     Image Guide
> >
> >     These guide targets users using an OpenStack cloud.
> >
> >     CLI Reference
> >
> >     This guide targets both cloud administrators and users using an
> >     OpenStack cloud.
> >
> >     Not covered personas:
> >
> >     Developer writing applications running in an OpenStack Cloud.
> >
> >
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
> >     Detailed information - copy of current abstract:
> >
> >     Install Guide
> >
> >     The OpenStack® system consists of several key projects that you
> >     install separately but that work together depending on your cloud
> >     needs. These projects include Compute, Identity Service, Networking,
> >     Image Service, Block Storage, Object Storage, Telemetry,
> >     Orchestration, and Database. You can install any of these projects
> >     separately and configure them stand-alone or as connected
> >     entities. This guide shows you how to install OpenStack by using
> >     packages on openSUSE through the Open Build Service Cloud
> >     repository. Explanations of configuration options and sample
> >     configuration files are included.
> >
> >
> >     Operations Guide
> >
> >     This book provides information about designing and operating
> OpenStack
> >     clouds.
> >
> >     Cloud Administrator Guide
> >
> >     OpenStack offers open source software for cloud administrators to
> >     manage and troubleshoot an OpenStack cloud.
> >
> >     Configuration Reference
> >
> >     This document is for system administrators who want to look up
> >     configuration options. It contains lists of configuration options
> >     available with OpenStack and uses auto-generation to generate options
> >     and the descriptions from the code for each project. It includes
> >     sample configuration files.
> >
> >     HA Guide
> >
> >     No abstract given.
> >
> >     Security Guide
> >
> >     This book provides best practices and conceptual information about
> >     securing an OpenStack cloud.
> >
> >     Admin User Guide
> >
> >     OpenStack is an open source cloud computing platform for public and
> >     private clouds. A series of interrelated projects deliver a cloud
> >     infrastructure solution. This guide shows OpenStack admin users how
> to
> >     create and manage resources in an OpenStack cloud with the OpenStack
> >     dashboard or OpenStack client commands.
> >
> >
> >     End User Guide
> >
> >     OpenStack is an open-source cloud computing platform for public and
> >     private clouds. A series of interrelated projects deliver a cloud
> >     infrastructure solution. This guide shows OpenStack end users how to
> >     create and manage resources in an OpenStack cloud with the OpenStack
> >     dashboard and OpenStack client commands.
> >
> >     Image Guide
> >
> >     This guide describes how to obtain, create, and modify virtual
> machine
> >     images that are compatible with OpenStack.
> >
> >     CLI Reference
> >
> >     This guide documents the OpenStack command-line clients.
> >
> >     --
> >      Andreas Jaeger aj@{suse.com <http://suse.com>,opensuse.org
> >     <http://opensuse.org>} Twitter/Identica: 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
> >     <mailto:Openstack-docs at lists.openstack.org>
> >     http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
> >
> >
>
>
> --
>  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
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20140520/3a2550ed/attachment.html>