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

[Sam Folk-Williams]

On Thu, Apr 27, 2006 at 01:45:05AM -0400, Debbie Deutsch wrote:
> 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]

Yep, sorry it's not clear in the outline -- I meant a lot of these things to be
links. My goal here is to address what a lot of new users ask -- from a support
perspective, the whole concept of iptables is totally mysterious to new users
and causes a lot of frustration. So, this would just be a brief blurb of "what
a firewall is in linux" with a link to some other place for more info.
> > 
> > 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...
> > 

Again, agree. I definitely think people who read the SPG will *need* to read
the Installation Guide. I'm trying to anticipate common questions and point to
the install guide for further reading.
> 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.
> 

Yup - we're on the same page. I will update the outline to reflect places I
imagine links should go rather than new content.

Sam
> Debbie
> 
> -- 
> fedora-docs-list mailing list
> fedora-docs-list at redhat.com
> To unsubscribe: 
> https://www.redhat.com/mailman/listinfo/fedora-docs-list

-- 
➧ Sam Folk-Williams, RHCE 	➧ Red Hat Global Support Services	
➧ Phone: 919/754-4558		➧ GPG ID: 1B0D46BA