discuss: Additional sections (was: Re: Firewall-HOWTO)
Subject:
Re: Additional sections (was: Re: Firewall-HOWTO)
From:
Tabatha Marshall ####@####.####
Date:
20 Nov 2003 22:41:16 -0000
Message-Id: <1069368047.6637.36.camel@mysticchild>
On Wed, 2003-11-19 at 11:00, Machtelt Garrels wrote:
> Somebody talked about having a sort of required prereqs section to each
> document, and then Terrence came up with the idea of an "I want more"
> section as well.
>
> Tabatha, this might be something to put on your list? I think each
> document should have both sections in some form, in so far as it is
> possible. This will also link our TLDP collection together in a better
> way.
I liked that idea too, and I'm cc'ing this to the reviewers. Let's look
out for these, and recommend them in the documentation. There may some
cases where these might not be useful, but in the majority of HOWTOs and
Guides, I think this can make an author's documentation more robust,
therefore more valuable to readers.
Tab
--
Tabatha Marshall
Web: www.merlinmonroe.com
Linux Documentation Project Review Coordinator (http://www.tldp.org)
Linux Counter Area Manager US:wa (http://counter.li.org)