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(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]
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(a)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