[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Slashdot reply (draft 0.1)
On Fri, Feb 11, 2000 at 10:26:51PM +0100, Hugo.van.der.Kooij@caiw.nl wrote:
[snip]
> But I agree the distinction between the various types should be made based
> on the content.
>
> So I suggest:
>
> - Howto Focus on getting the job done
> - Guide Focus on telling you what the subject is al about
> - FAQ Questions and Answers
> - Others
I strongly agree. Having to submit a doc as a FAQ because its plain text, or a
HOWTO because its in linuxdoc-sgml (as I just did) is crazy.
I also think that the Guide category is very important and neglected. A few
days ago I suggested a TUTE category, but I now see that Guides could cover
that role. Especially if authors include exercises in their docs. I think I
read somewhere that Guides are supposed to be book size. I don't see why this
should be the case. It all depends on the size of the subject.
GregO
--
learning@TasLUG, where people get together and
learn about Linux http://learning.taslug.org.au
--
To UNSUBSCRIBE, email to ldp-discuss-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org