<div dir="ltr">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.<div><br></div><div>The audience statement is more like "Who this Book is For" in the Ops Guide:</div>
<div><br></div><div><a href="http://docs.openstack.org/trunk/openstack-ops/content/openstack-ops_preface.html#who-this-book-is-for">http://docs.openstack.org/trunk/openstack-ops/content/openstack-ops_preface.html#who-this-book-is-for</a><br>
</div></div><div class="gmail_extra"><br><br><div class="gmail_quote">On Tue, May 20, 2014 at 2:36 AM, Andreas Jaeger <span dir="ltr"><<a href="mailto:aj@suse.com" target="_blank">aj@suse.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div class="">On 05/20/2014 07:18 AM, Anne Gentle wrote:<br>
> Thanks for analyzing Andreas and Randy!<br>
><br>
> I like these three simple personas below.<br>
><br>
> Alice the admin<br>
> Alice is an administrator who is responsible for maintaining (and<br>
> securing) the OpenStack cloud installation. She has many years of<br>
> experience with Linux systems administration.<br>
><br>
> Darren the deployer<br>
> Darren is responsible for doing the initial OpenStack deployment on the<br>
> host machines.<br>
> Emile the end-user<br>
> Emile uses the cloud to do software development inside of the virtual<br>
> machines. She uses the command-line tools because she finds it quicker<br>
> than using the dashboard.<br>
<br>
</div>Yes, these are fine - but let's rename Alice since Alice and Bob are the<br>
two persons used in the Security Guide explaining the two different setups.<br>
<div class=""><br>
> To me, Emile is a useful persona because she uses user tools and<br>
> developer tools -- and I do see a lot of blending across user/dev tools.<br>
> Andreas, the user we haven't yet started to document for is the<br>
> application devops role, the operator who would monitor applications in<br>
> the cloud. They might be super specialized for monitoring of the VMs<br>
> themselves.<br>
><br>
> But I'm not sure whether there's a fourth persona who does planning and<br>
> setup, what do you all think? Archie the architect?<br>
<br>
</div>So, the OPS guide would be for Archie?<br>
<div class=""><br>
> We also don't have to be super pattern-based, we can just write a<br>
> section describing the audience for each guide.<br>
<br>
</div>;)<br>
<br>
Andreas<br>
<div class=""><br>
><br>
> On Mon, May 19, 2014 at 3:41 PM, Andreas Jaeger <<a href="mailto:aj@suse.com">aj@suse.com</a><br>
</div><div><div class="h5">> <mailto:<a href="mailto:aj@suse.com">aj@suse.com</a>>> wrote:<br>
><br>
> We had some discussion about target audience for each guide at the<br>
> OpenStack summit and Anne filed this bug:<br>
> <a href="https://bugs.launchpad.net/openstack-manuals/+bug/1319394" target="_blank">https://bugs.launchpad.net/openstack-manuals/+bug/1319394</a> . As a first<br>
> step, I've went over all guides and categorized them according to target<br>
> audience and then copied all the current abstracts together. Is the<br>
> following accurate?<br>
><br>
> Andreas<br>
><br>
> Overview of personas/target audience:<br>
><br>
> Operations Guide<br>
> Cloud Administrator Guide<br>
> Configuration Reference<br>
> HA Guide<br>
> Install Guide<br>
> Security Guide<br>
> Admin User Guide<br>
><br>
> These guides target cloud administrators who sets up an OpenStack<br>
> cloud and configures the OpenStack services.<br>
><br>
> End User Guide<br>
> Image Guide<br>
><br>
> These guide targets users using an OpenStack cloud.<br>
><br>
> CLI Reference<br>
><br>
> This guide targets both cloud administrators and users using an<br>
> OpenStack cloud.<br>
><br>
> Not covered personas:<br>
><br>
> Developer writing applications running in an OpenStack Cloud.<br>
><br>
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~<br>
> Detailed information - copy of current abstract:<br>
><br>
> Install Guide<br>
><br>
> The OpenStack® system consists of several key projects that you<br>
> install separately but that work together depending on your cloud<br>
> needs. These projects include Compute, Identity Service, Networking,<br>
> Image Service, Block Storage, Object Storage, Telemetry,<br>
> Orchestration, and Database. You can install any of these projects<br>
> separately and configure them stand-alone or as connected<br>
> entities. This guide shows you how to install OpenStack by using<br>
> packages on openSUSE through the Open Build Service Cloud<br>
> repository. Explanations of configuration options and sample<br>
> configuration files are included.<br>
><br>
><br>
> Operations Guide<br>
><br>
> This book provides information about designing and operating OpenStack<br>
> clouds.<br>
><br>
> Cloud Administrator Guide<br>
><br>
> OpenStack offers open source software for cloud administrators to<br>
> manage and troubleshoot an OpenStack cloud.<br>
><br>
> Configuration Reference<br>
><br>
> This document is for system administrators who want to look up<br>
> configuration options. It contains lists of configuration options<br>
> available with OpenStack and uses auto-generation to generate options<br>
> and the descriptions from the code for each project. It includes<br>
> sample configuration files.<br>
><br>
> HA Guide<br>
><br>
> No abstract given.<br>
><br>
> Security Guide<br>
><br>
> This book provides best practices and conceptual information about<br>
> securing an OpenStack cloud.<br>
><br>
> Admin User Guide<br>
><br>
> OpenStack is an open source cloud computing platform for public and<br>
> private clouds. A series of interrelated projects deliver a cloud<br>
> infrastructure solution. This guide shows OpenStack admin users how to<br>
> create and manage resources in an OpenStack cloud with the OpenStack<br>
> dashboard or OpenStack client commands.<br>
><br>
><br>
> End User Guide<br>
><br>
> OpenStack is an open-source cloud computing platform for public and<br>
> private clouds. A series of interrelated projects deliver a cloud<br>
> infrastructure solution. This guide shows OpenStack end users how to<br>
> create and manage resources in an OpenStack cloud with the OpenStack<br>
> dashboard and OpenStack client commands.<br>
><br>
> Image Guide<br>
><br>
> This guide describes how to obtain, create, and modify virtual machine<br>
> images that are compatible with OpenStack.<br>
><br>
> CLI Reference<br>
><br>
> This guide documents the OpenStack command-line clients.<br>
><br>
> --<br>
</div></div>> Andreas Jaeger aj@{<a href="http://suse.com" target="_blank">suse.com</a> <<a href="http://suse.com" target="_blank">http://suse.com</a>>,<a href="http://opensuse.org" target="_blank">opensuse.org</a><br>
> <<a href="http://opensuse.org" target="_blank">http://opensuse.org</a>>} Twitter/Identica: jaegerandi<br>
<div class="">> SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany<br>
> GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg)<br>
> GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1 389A 563C C272 A126<br>
><br>
> _______________________________________________<br>
> Openstack-docs mailing list<br>
> <a href="mailto:Openstack-docs@lists.openstack.org">Openstack-docs@lists.openstack.org</a><br>
</div>> <mailto:<a href="mailto:Openstack-docs@lists.openstack.org">Openstack-docs@lists.openstack.org</a>><br>
> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
><br>
><br>
<span class="HOEnZb"><font color="#888888"><br>
<br>
--<br>
Andreas Jaeger aj@{<a href="http://suse.com" target="_blank">suse.com</a>,<a href="http://opensuse.org" target="_blank">opensuse.org</a>} Twitter: jaegerandi<br>
</font></span><div class="HOEnZb"><div class="h5"> SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany<br>
GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg)<br>
GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1 389A 563C C272 A126<br>
</div></div></blockquote></div><br></div>