Proposed plan for the Virtualization Getting Started Guide
Corey Sheldon
sheldon.corey at gmail.com
Tue Mar 17 20:45:30 UTC 2015
I am more than willing to help proof-read / add /remove content to help
clean /clarify things up
Corey W Sheldon
Freelance IT Consultant, Multi-Discipline Tutor
(p) 310.909.7672
G+: <https://www.plus.google.com/+CoreySheldon>
LinkedIn: <https://www.linkedin.com/profile/view?id=70127804>
Github: <https://www.github.com/linux-modder>
Facebook: <https://www.facebook.com/corey.sheldon>
Several Communities on Stack Exchange <https://www.stackexchange.com>
<http://www.facebook.com/1stclassmobileshine>
Tutoring in person or via any of the following platforms:
HackHands <https://www.hackhands.com>
Wizpert <https://www.wizperts.com>
FieldNation <https://www.fieldnation.com>
AirPair <https://www.airpair.com>
TrueLancer
{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 Tue, Mar 17, 2015 at 4:31 PM, Sandra McCann <scmccann2000 at gmail.com>
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 :-)
>
> - 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.
>
> - 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.
>
> - 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.
>
> Thanks,
> Sandra
>
> On Mon, Mar 16, 2015 at 10:16 PM, Dayle Parker <dayleparker at redhat.com>
> 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
>> <https://fedoraproject.org/wiki/Docs_Project_Focus#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
>> <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>.
>> (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 -
>>
>> -
>>
>> not sure what to do about the list of emulated devices - is it
>> accurate?
>> http://docs.fedoraproject.org/en-US/Fedora/19/html/Virtualization_Getting_Started_Guide/sec-virtualized-hardware-devices.html
>>
>>
>> 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 at fedoraproject.org
>>
>>
>>
>>
>>
>>
>>
>>
>> --
>> Dayle Parker
>> Senior Technical Writer
>> Red Hat Asia Pacific - Brisbane, Australiadayleparker at redhat.com
>>
>>
>
> --
> docs mailing list
> docs at lists.fedoraproject.org
> To unsubscribe:
> https://admin.fedoraproject.org/mailman/listinfo/docs
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.fedoraproject.org/pipermail/docs/attachments/20150317/2b97eab6/attachment.html>
More information about the docs
mailing list