Paul W. Frields wrote:
Comments below:
On Wed, 2006-04-26 at 19:35 +0000, fedorawiki-noreply(a)fedoraproject.org
wrote:
> The following page has been changed by SamFolkWilliams:
>
http://fedora.linux.duke.edu/wiki/Docs/Drafts/SystemPlanningGuide
>
> ------------------------------------------------------------------------------
[...snip...]
> - What is open source, how that affects
> + 1. Before you begin the install
> + * Decide how to structure your file system
> + * Case scenarios
> + * Example configurations
> + * Decide if you wish to use LVM and/or software RAID
> + * Benefits of
> + * Hardware requirements
> + * Limitations
> + * Determine your firewall requirements
> + * Overview of how iptables works
^^^^^^^^^^^^^^^^^^^^^^^^^
How much detail here is going to be dependent on the target audience.
To determine your target audience, define what knowledge, skills, and
abilities a reader must possess for this guide to be useful.
I think it would be useful for the contributors to discuss the target
audience before filling in too much more detail here. Such a discussion
would probably cut down on effort spent arguing over how much
information to include.
[SNIP]
Careful here, this is starting to look somewhat repetitive with the
Installation Guide! I would recommend everyone read that cover-to-cover
to familiarize themselves with the content. No reason you can't argue
to move something out of the IG and into the SPG, but again, conserve
energy where possible...
Yeah, I had been imagining a document that had its primary emphasis
getting someone who has lived in the world of Windows oriented and
comfortable. That person might be a desktop user who has never
installed an operating system before. The would anticipate the
inevitable incorrect assumptions before the reader stubbed his virtual
toes on them. The document would be mostly about what the reader needs
to know and understand and not so much about how to perform any given
task. As you say, that's what the installation guide is for.
Debbie