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

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

 



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

-- 

fedora-docs-list@xxxxxxxxxx
To unsubscribe: 
https://www.redhat.com/mailman/listinfo/fedora-docs-list

[Index of Archives]     [Fedora Users]     [Fedora Desktop]     [Red Hat 9]     [Yosemite News]     [KDE Users]

  Powered by Linux