Date: Thu, 19 Dec 1996 20:23:10 +0200 (IST)
From: Eli Zaretskii <eliz AT is DOT elta DOT co DOT il>
To: DJ Delorie <dj AT delorie DOT com>
cc: djgpp-workers AT delorie DOT com
Subject: Re: Split FAQ & Users Guide
In-Reply-To: <199612191800.NAA24956@delorie.com>
Message-ID: <Pine.SUN.3.91.961219201718.26067D-100000@is>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII


On Thu, 19 Dec 1996, DJ Delorie wrote:

> Suppose we start a UG based on the FAQ, and limit the FAQ to the more
> esoteric questions, under the assumption that the UG will eliminate
> the more frequently asked questions, leaving the less frequent ones to
> need an FAQ.

The name (UG, KB or FAQ) isn't what bugs me.  My notion of the UG is 
probably totally different from yours, because I'm afraid the FAQ will 
have to be rewritten from scratch to make a good UG.  The current FAQ is 
made of relatively short and very loosely coupled notes.  Making it a 
coherent guide is IMHO as hard as writing a guide from scratch.

But maybe I just don't think clearly enough.  Could anybody mention 
examples of good user guides for software packages (even commercial) 
that I could then look up and see if I'm not haunted by the shadow of a 
dwarf?  Thanks.