[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:
> 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.


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