<html>
<head>
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
</head>
<body bgcolor="#FFFFFF" text="#000000">
<div class="moz-cite-prefix">On 03/16/2015 02:28 PM, Sandra McCann
wrote:<br>
</div>
<blockquote
cite="mid:CALz5XzXHP=+kephG73YYF8Rv1k=J8rmkqJxo1Padbbj6sgXLSQ@mail.gmail.com"
type="cite">
<div dir="ltr">
<div><br>
</div>
<div><span
id="docs-internal-guid-af2cb962-2444-c593-0176-ac02147542a5">
<p dir="ltr"
style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span
style="font-size:15px;font-family:Arial;color:rgb(0,0,0);vertical-align:baseline;white-space:pre-wrap;background-color:transparent">Hi
folks -</span></p>
<br>
<p dir="ltr"
style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span
style="font-size:15px;font-family:Arial;color:rgb(0,0,0);vertical-align:baseline;white-space:pre-wrap;background-color:transparent">We’ve
been batting around ideas for the virtualization guides
for a bit now in irc, but I’d like to get some more
feedback on the approach we can take.</span></p>
<br>
<p dir="ltr"
style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span
style="font-size:15px;font-family:Arial;color:rgb(0,0,0);vertical-align:baseline;white-space:pre-wrap;background-color:transparent">Seems
there are two personas involved. Using our </span><a
moz-do-not-send="true"
href="https://fedoraproject.org/wiki/Docs_Project_Focus#Personas"
style="text-decoration:none"><span
style="font-size:15px;font-family:Arial;text-decoration:underline;vertical-align:baseline;white-space:pre-wrap;background-color:transparent">draft
personas</span></a><span
style="font-size:13px;font-family:Verdana;color:rgb(0,0,0);vertical-align:baseline;white-space:pre-wrap;background-color:rgb(255,255,255)">
we have :</span></p>
<ul style="margin-top:0pt;margin-bottom:0pt">
<li dir="ltr"
style="list-style-type:disc;font-size:13px;font-family:Verdana;color:rgb(0,0,0);vertical-align:baseline">
<p dir="ltr"
style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span
style="vertical-align:baseline;white-space:pre-wrap;background-color:rgb(255,255,255)">Technical
Tony - experienced IT person virtualizing on servers
etc, knows his stuff and is spinning up VMs like
they’re candy.</span></p>
</li>
<li dir="ltr"
style="list-style-type:disc;font-size:13px;font-family:Verdana;color:rgb(0,0,0);vertical-align:baseline">
<p dir="ltr"
style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span
style="vertical-align:baseline;white-space:pre-wrap;background-color:rgb(255,255,255)">Novice
Ned (or Novice Nancy in my case :-) - Fairly new to
virtualization, and looking to spin up a VM or two
for her own work.</span></p>
</li>
</ul>
<span style="background-color:rgb(255,255,255)"><br>
</span>
<p dir="ltr"
style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span
style="font-size:13px;font-family:Verdana;color:rgb(0,0,0);vertical-align:baseline;white-space:pre-wrap;background-color:rgb(255,255,255)">Given
these two personas, I’d like to suggest that the
Virtualization Getting Started guide be targeted to
Novice Nancy. To do this we would:</span></p>
<ul style="margin-top:0pt;margin-bottom:0pt">
<li dir="ltr"
style="list-style-type:disc;font-size:13px;font-family:Verdana;color:rgb(0,0,0);vertical-align:baseline">
<p dir="ltr"
style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span
style="vertical-align:baseline;white-space:pre-wrap;background-color:rgb(255,255,255)">Add
an installing virtualization tools chapter - simple
effort to install the virtualization group package
and bring up virt-manager. (smccann)</span></p>
</li>
<li dir="ltr"
style="list-style-type:disc;font-size:13px;font-family:Verdana;color:rgb(0,0,0);vertical-align:baseline">
<p dir="ltr"
style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span
style="background-color:rgb(255,255,255)"><span
style="vertical-align:baseline;white-space:pre-wrap">Add
an ‘Creating Guests with Virt-Manager chapter -
copying from </span><a moz-do-not-send="true"
href="http://docs.fedoraproject.org/en-US/Fedora_Draft_Documentation/0.1/html/Virtualization_Deployment_and_Administration_Guide/chap-Virtualization_Host_Configuration_and_Guest_Installation_Guide-Guest_Installation_Virt_Manager-Creating_guests_with_virt_manager.html"
style="text-decoration:none"><span
style="text-decoration:underline;vertical-align:baseline;white-space:pre-wrap">here</span></a><span
style="vertical-align:baseline;white-space:pre-wrap">. (smccann)</span></span></p>
</li>
<li dir="ltr"
style="list-style-type:disc;font-size:13px;font-family:Verdana;color:rgb(0,0,0);vertical-align:baseline">
<p dir="ltr"
style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span
style="vertical-align:baseline;white-space:pre-wrap;background-color:rgb(255,255,255)">Adding
a ‘Creating Guests with Boxes chapter (grundblom)</span></p>
</li>
<li dir="ltr"
style="list-style-type:disc;font-size:13px;font-family:Verdana;color:rgb(0,0,0);vertical-align:baseline">
<p dir="ltr"
style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span
style="vertical-align:baseline;white-space:pre-wrap;background-color:rgb(255,255,255)">Make
minor edits as needed to remove Fedora 19 references
and any references (if present) to a larger set of
virtualization guides that may not be available as
F21 guides yet.</span></p>
</li>
</ul>
<span style="background-color:rgb(255,255,255)"><br>
</span>
<p dir="ltr"
style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span
style="font-size:13px;font-family:Verdana;color:rgb(0,0,0);vertical-align:baseline;white-space:pre-wrap;background-color:rgb(255,255,255)">I
also had one question - </span></p>
<ul style="margin-top:0pt;margin-bottom:0pt">
<li dir="ltr"
style="list-style-type:disc;font-size:13px;font-family:Verdana;color:rgb(0,0,0);vertical-align:baseline">
<p dir="ltr"
style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span
style="background-color:rgb(255,255,255)"><span
style="vertical-align:baseline;white-space:pre-wrap">not
sure what to do about the list of emulated devices
- is it accurate? </span><a
moz-do-not-send="true"
href="http://docs.fedoraproject.org/en-US/Fedora/19/html/Virtualization_Getting_Started_Guide/sec-virtualized-hardware-devices.html"
style="text-decoration:none"><span
style="text-decoration:underline;vertical-align:baseline;white-space:pre-wrap">http://docs.fedoraproject.org/en-US/Fedora/19/html/Virtualization_Getting_Started_Guide/sec-virtualized-hardware-devices.html</span></a></span></p>
</li>
</ul>
<span style="background-color:rgb(255,255,255)"><br>
</span>
<p dir="ltr"
style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span
style="font-size:13px;font-family:Verdana;color:rgb(0,0,0);vertical-align:baseline;white-space:pre-wrap;background-color:rgb(255,255,255)">Anyway,
I’d like to get the getting started done and committed
before considering the Admin and Deploy guide
(because..ahem.. I AM Novice Nancy here and it will take
longer for me to parse that guide).</span></p>
<span style="background-color:rgb(255,255,255)"><br>
</span>
<p dir="ltr"
style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span
style="font-size:13px;font-family:Verdana;color:rgb(0,0,0);vertical-align:baseline;white-space:pre-wrap;background-color:rgb(255,255,255)">Thoughts?</span></p>
<p dir="ltr"
style="line-height:1.38;margin-top:0pt;margin-bottom:0pt"><span
style="font-size:13px;font-family:Verdana;color:rgb(0,0,0);vertical-align:baseline;white-space:pre-wrap;background-color:rgb(255,255,255)">Sandra</span></p>
<div><span
style="font-size:13px;font-family:Verdana;color:rgb(0,0,0);vertical-align:baseline;white-space:pre-wrap;background-color:rgb(240,247,255)"><br>
</span></div>
</span></div>
</div>
<br>
<fieldset class="mimeAttachmentHeader"></fieldset>
<br>
</blockquote>
This seems like a solid plan to me. There's a lot of content in the
guide now that's reads strictly as a launch point for the larger
guides, so something more like purging paragraphs might be more
appropriate than simply removing references. You have a good idea
of where you want to go with it; I only make that point to ensure
you don't feel obligated to keep the existing content and write
around it.<br>
<br>
The hardware list is accurate, but not complete. You might want to
focus on a few specific pieces of hardware instead of listing and
explaining all possible options though, ie:<br>
<br>
This is how you add a network device. This virtio option might
need these extra drivers on a windows guest. <br>
<br>
This is how you add a virtual block device. This virtio option
might need these extra drivers on a windows guest. ( depending on
how deep you want to go, you could cover switching out a windows
installation iso for the virtio driver iso so it can see virtio
storage, then switching back. There's a definite performance
improvement in virtio over SATA emulation, but the setup is going to
add a page or two to your instructions) <br>
<br>
This is how you provide an ISO to the guest.<br>
<br>
This is how you share part of the host filesystem with a linux
guest<br>
<br>
These are all spice related devices. If you choose spice ( the
default ) you get them automatically, here is what they do.<br>
<br>
<br>
<br>
Things like memory, CPU, input devices are set up automatically, or
during initial creation. IMO my the time you have documented the
device types that might need some explanation, the user is familiar
with the device management screen and knows where to go, they don't
need much or any explanation.<br>
<br>
Your plan seems GUI focused; I like that. It makes for a much
easier read for new users when it doesn't look like you need to
learn a bunch of scary programming to make it work :) We can put
cli stuff somewhere else.<br>
<br>
<pre class="moz-signature" cols="72">--
-- Pete Travis
- Fedora Docs Project Leadt
- 'randomuser' on freenode
- <a class="moz-txt-link-abbreviated" href="mailto:immanetize@fedoraproject.org">immanetize@fedoraproject.org</a></pre>
</body>
</html>