On Wed, Feb 24, 2010 at 8:48 AM, Skip Cave <[email protected]> wrote:
> That is the primary difficulty with a random-access reference/tutorial.
> How can you make every NuVoc page provide enough information so that it
> can be the first page that a novice sees, and still provide all the
> information they need to understand the specific symbol that they are
> looking up?

If you are creating documentation for novices, some redundancy
can be very helpful.

But, at some point I think you have to have prerequisites,
which treat introductory issues in some detail.  Then the difficulty
become minimizing the number and depth of the prerequisites.

-- 
Raul
----------------------------------------------------------------------
For information about J forums see http://www.jsoftware.com/forums.htm

Reply via email to