[Fedora Project Wiki] Update of "Docs/Drafts/SystemPlanningGuide" by SamFolkWilliams

Debbie Deutsch fedora-docs at ddeutsch.net
Thu Apr 27 05:45:05 UTC 2006


Paul W. Frields wrote:
> Comments below:
> 
> On Wed, 2006-04-26 at 19:35 +0000, fedorawiki-noreply at 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




More information about the fedora-docs-list mailing list