Open Stack

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