<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40"><head><meta http-equiv=Content-Type content="text/html; charset=utf-8"><meta name=Generator content="Microsoft Word 14 (filtered medium)"><style><!--
/* Font Definitions */
@font-face
{font-family:Wingdings;
panose-1:5 0 0 0 0 0 0 0 0 0;}
@font-face
{font-family:SimSun;
panose-1:2 1 6 0 3 1 1 1 1 1;}
@font-face
{font-family:SimSun;
panose-1:2 1 6 0 3 1 1 1 1 1;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
@font-face
{font-family:Tahoma;
panose-1:2 11 6 4 3 5 4 4 2 4;}
@font-face
{font-family:"\@SimSun";
panose-1:2 1 6 0 3 1 1 1 1 1;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0in;
margin-bottom:.0001pt;
font-size:12.0pt;
font-family:"Times New Roman","serif";}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:blue;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{mso-style-priority:99;
color:purple;
text-decoration:underline;}
span.hoenzb
{mso-style-name:hoenzb;}
span.EmailStyle18
{mso-style-type:personal-reply;
font-family:"Calibri","sans-serif";
color:#1F497D;}
.MsoChpDefault
{mso-style-type:export-only;
font-family:"Calibri","sans-serif";}
@page WordSection1
{size:8.5in 11.0in;
margin:1.0in 1.0in 1.0in 1.0in;}
div.WordSection1
{page:WordSection1;}
--></style><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]--></head><body lang=EN-US link=blue vlink=purple><div class=WordSection1><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D'>I like the persona and their needs. One item I like especially is Alice has an experience level “many year of experience with Linux system administration”; do we need that for the others?<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D'>Darren the deployer is experience with deployment of different Application and OS systems and responsible for deployment and documentation of the OpenStack Cluster prior to release to Alice. <o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D'>Emile the user has years of experience with using Linux based tool sets and is comfortable using both GUI and CLI based tools.<o:p></o:p></span></p><div style='mso-element:para-border-div;border:none;border-bottom:solid windowtext 1.0pt;padding:0in 0in 1.0pt 0in'><p class=MsoNormal style='border:none;padding:0in'><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D'><o:p> </o:p></span></p></div><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D'>I may be a little too picky here.<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:Wingdings;color:#1F497D'>J</span><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D'><o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D'><o:p> </o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D'>-Randy<o:p></o:p></span></p><p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D'><o:p> </o:p></span></p><p class=MsoNormal><b><span style='font-size:10.0pt;font-family:"Tahoma","sans-serif"'>From:</span></b><span style='font-size:10.0pt;font-family:"Tahoma","sans-serif"'> Anne Gentle [mailto:anne@openstack.org] <br><b>Sent:</b> Tuesday, May 20, 2014 8:12 AM<br><b>To:</b> Andreas Jaeger<br><b>Cc:</b> openstack-docs@lists.openstack.org<br><b>Subject:</b> Re: [Openstack-docs] Target audience<o:p></o:p></span></p><p class=MsoNormal><o:p> </o:p></p><div><p class=MsoNormal>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.<o:p></o:p></p><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal>The audience statement is more like "Who this Book is For" in the Ops Guide:<o:p></o:p></p></div><div><p class=MsoNormal><o:p> </o:p></p></div><div><p class=MsoNormal><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><o:p></o:p></p></div></div><div><p class=MsoNormal style='margin-bottom:12.0pt'><o:p> </o:p></p><div><p class=MsoNormal>On Tue, May 20, 2014 at 2:36 AM, Andreas Jaeger <<a href="mailto:aj@suse.com" target="_blank">aj@suse.com</a>> wrote:<o:p></o:p></p><div><p class=MsoNormal style='margin-bottom:12.0pt'>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.<o:p></o:p></p></div><p class=MsoNormal>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.<o:p></o:p></p><div><p class=MsoNormal style='margin-bottom:12.0pt'><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?<o:p></o:p></p></div><p class=MsoNormal>So, the OPS guide would be for Archie?<o:p></o:p></p><div><p class=MsoNormal style='margin-bottom:12.0pt'><br>> We also don't have to be super pattern-based, we can just write a<br>> section describing the audience for each guide.<o:p></o:p></p></div><p class=MsoNormal>;)<br><br>Andreas<o:p></o:p></p><div><p class=MsoNormal><br>><br>> On Mon, May 19, 2014 at 3:41 PM, Andreas Jaeger <<a href="mailto:aj@suse.com">aj@suse.com</a><o:p></o:p></p></div><div><div><p class=MsoNormal>> <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>> --<o:p></o:p></p></div></div><p class=MsoNormal>> 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<o:p></o:p></p><div><p class=MsoNormal>> 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><o:p></o:p></p></div><p class=MsoNormal>> <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 style='color:#888888'><br><br><span class=hoenzb>--</span><br><span class=hoenzb> 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</span></span><o:p></o:p></p><div><div><p class=MsoNormal> 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<o:p></o:p></p></div></div></div><p class=MsoNormal><o:p> </o:p></p></div></div></body></html>