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@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] 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@xxxxxxxxxx > 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 -- fedora-docs-list@xxxxxxxxxx To unsubscribe: https://www.redhat.com/mailman/listinfo/fedora-docs-list
