Re: Proposed plan for the Virtualization Getting Started Guide

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On 03/18/2015 02:36 AM, Corey Sheldon wrote:
@ Glen,

I'll take a long look today and tomorrow and edit or comment on where /what can be added for you, as  I agree the libvirt /boxes guides are a bit "too techy biased" and/or  a bit dated

Corey W Sheldon
Freelance IT Consultant, Multi-Discipline Tutor
(p) 310.909.7672

Tutoring in person or via any of the following platforms:

{PayPal,Google Wallet/Play store, Apple Pay}
-----BEGIN PGP PUBLIC KEY BLOCK-----
Version: GnuPG v1

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
=v6Cq
-----END PGP PUBLIC KEY BLOCK-----





On Wed, Mar 18, 2015 at 1:22 AM, Dayle Parker <dayleparker@xxxxxxxxxx> wrote:
Hi Sandra,

Thanks for the feedback! A bit of background and links below...

On 03/18/2015 06:31 AM, Sandra McCann wrote:
Thanks Dayle!

I took a look at your RHEL quickstart and the flow is quite similar to what I'm proposing.  I had a few comments:

 - yum install - does RHEL support yum groupinstall? That's what I was going to document instead of the individual installs.  I have a small section after that to describe what some of the packages do (for the curious newbie :-)

 Yes, RHEL does support yum groupinstall - that might indeed be simpler. Here's the RHEL virt package groups, in case it helps. I'm not sure if they're the same in Fedora:

https://access.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/Virtualization_Deployment_and_Administration_Guide/sect-Installing_the_virtualization_packages-Installing_virtualization_packages_on_an_existing_Red_Hat_Enterprise_Linux_system.html

Great idea on providing a little bit of info on those packages for the more curious :)

 - screencaps - I debated this one and was leaning toward only having one or two for virt-manager. Most of the steps are obvious when you look at the virt-manager gui, so I thought I could get away with less images to create/maintain.  That said, your approach makes it very obvious what screen the user should be on, so now I'm waffling on which approach to take.

 Agreed, fewer screenshots is always better from a maintenance perspective. I wasn't sure either how many to include, but went for the whole set of them, just to be extra clear -- also it's what we had in the Virt Deployment and Admin Guide. The "New VM" wizard screenshots probably aren't necessary, they're more like an assurance for the user that they're in the right spot.


 - other options to spin up a VM - I mention some of the other options in a list, just so the newbie user is aware. I figure only virt-manager and boxes will actually be covered in detail, and the rest would be in the admin/deploy guide.

 Nice. Yeah, originally I planned on including some basic commands, but I decided against it for the Getting Started Guide so as to not confuse brand new users with too many options.

 - boxes - I'm guessing this is only in Fedora, not RHEL?  Anyway, I'm leaning toward having boxes as the first procedure to cover, since it's installed by default in Fedora workstation, where the newbie user is.  Then a separate chapter for virt-manager.

 That makes sense. Boxes is in RHEL actually, but didn't seem like a feature an enterprise user would use much, so we opted for a short Boxes description in the Getting Started Guide, and a chapter in the VDAG (below). Is Boxes used extensively by Fedora users?

https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html-single/Virtualization_Getting_Started_Guide/index.html#sect-Virtualization_Getting_Started-Tools-Boxes

https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/Virtualization_Deployment_and_Administration_Guide/sect-Graphic_User_Interface_tools_for_guest_virtual_machine_management-GNOME_Boxes.html

Hope that helps a bit. :)
Cheers,
Dayle



Thanks,
Sandra

On Mon, Mar 16, 2015 at 10:16 PM, Dayle Parker <dayleparker@xxxxxxxxxx> wrote:
Hey Sandra,

Thanks for initiating this! I help maintain this guide for RHEL and have sadly been too busy lately to get very involved on the Fedora side of things. :(

I've been also looking at whether this book has the right user in mind for RHEL, and I think currently it's aimed at too many types of users -- I agree, the novice/GUI focus sounds best. I think some of this guide gets pretty technical and detailed in parts, and is probably not needed for a novice user.

I've actually added a quick start chapter to the end of the guide [1] for RHEL7, so if you want to use any of it (the content is under the http://creativecommons.org/licenses/by-sa/3.0/ license), go for it. (Or if you have any feedback on that chapter as a novice, feel free to share).

Also, let me know if you need any help with the project -- I really appreciate you taking it on, and I'm happy to contribute in little bits if I can!

Cheers,
Dayle



[1] https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/Virtualization_Getting_Started_Guide/chap-Virtualization_Getting_Started-Quickstart.html



On 03/17/2015 11:03 AM, Glen Rundblom wrote:
I agree with the plan, and I am happy that Sandra proposed this direction. I have been thinking of how to word my Boxes guide: is this a how-to manual, or just just technical instructions. For me: I learn more from how-to manuals and branch into technical details as I need them. Also, working with the Novice in mind makes me think of the "what if the person does not see..." or "what if they encounter that" and try to solve issues they may encounter as they try to do the task, but may not have the ability to troubleshoot an issue that just happened during the process.

Also, writing for Novices/How-to is more forgiving of first and second person voicing, which I have a tendency to do.

So I have been working with the mindset of a how-to manual for someone beginning with the application, because I am learning the application, publican, docbook, git, mailing lists, and Linux all together!)

I have this conception that the more friendly and built for novices something is, the more solid and polished it seems. I am more then willing to put more time and work to make to do that.

So, thank you Sandra!

-Glen


On 03/16/2015 05:51 PM, Pete Travis wrote:
On 03/16/2015 02:28 PM, Sandra McCann wrote:

Hi folks -


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.


Seems there are two personas involved. Using our draft personas we have :

  • Technical Tony - experienced IT person virtualizing on servers etc, knows his stuff and is spinning up VMs like they’re candy.

  • 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.

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:

  • Add an installing virtualization tools chapter - simple effort to install the virtualization group package and bring up virt-manager. (smccann)

  • Add an ‘Creating Guests with Virt-Manager chapter - copying from here. (smccann)

  • Adding a ‘Creating Guests with Boxes chapter (grundblom)

  • 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.

I also had one question -


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).

Thoughts?

Sandra




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.

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:

    This is how you add a network device.  This virtio option might need these extra drivers on a windows guest. 

    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)

    This is how you provide an ISO to the guest.

    This is how you share part of the host filesystem with a linux guest

    These are all spice related devices.  If you choose spice ( the default ) you get them automatically, here is what they do.



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.

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.

-- 
-- Pete Travis
 - Fedora Docs Project Leadt
 - 'randomuser' on freenode
 - immanetize@xxxxxxxxxxxxxxxxx







-- 
Dayle Parker
Senior Technical Writer
Red Hat Asia Pacific - Brisbane, Australia
dayleparker@xxxxxxxxxx 



-- 
Dayle Parker
Senior Technical Writer
Platform Virtualization Docs Lead

Red Hat Asia Pacific - Brisbane, Australia
dayleparker@xxxxxxxxxx | irc: dayle

--
docs mailing list
docs@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe:
https://admin.fedoraproject.org/mailman/listinfo/docs



Thank you, I pushed my latest commit to my FedoraPeople repo, I am having a hard time getting a section to build in publican. I think the Products.xml page is too long and I should break it out into individual chapters instead of one big page.

My personal git repo for this I have been using is here: git://fedorapeople.org/~grundblom/virtualization-getting-started-guide.git

Thank you,
-Glen

-- 
docs mailing list
docs@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe:
https://admin.fedoraproject.org/mailman/listinfo/docs
[Index of Archives]     [Fedora Users]     [Fedora Desktop]     [Red Hat 9]     [Yosemite News]     [KDE Users]

  Powered by Linux