discuss: Howto and annex/appendix
Subject:
Re: Howto and annex/appendix
From:
"Rodolfo J. Paiz" ####@####.####
Date:
6 Feb 2005 15:46:08 -0000
Message-Id: <1107704749.5202.97.camel@localhost.localdomain>
On Sun, 2005-02-06 at 09:36 -0500, Nicolas Dufour wrote:
> I was wondering if when you write a howto, it could be good to add
> annexes or appendixes to explain some part of the domain : here Linux
> Aviation => so to explain to newbies not trivial words or problems.
>
> What do you think about it ?
>
My personal methodology is to explain anything I feel needs to be
explained. Then I move to an Appendix whatever may not be applicable or
interesting to *most* people during their reading of the document.
The idea is that the majority of people won't be slowed down or bored by
material that is irrelevant to them, but those who do need that material
for whatever reason will find it easily.
Cheers,
--
Rodolfo J. Paiz ####@####.####
