Date: Wed, 10 Jan 2001 09:45:51 -0500
Message-Id: <200101101445.JAA22714@envy.delorie.com>
X-Authentication-Warning: envy.delorie.com: dj set sender to dj AT envy DOT delorie DOT com using -f
From: DJ Delorie <dj AT delorie DOT com>
To: djgpp-workers AT delorie DOT com
In-reply-to: <20010110083821.B24622@kendall.sfbr.org> (message from JT
	Williams on Wed, 10 Jan 2001 08:38:21 -0600)
Subject: Re: Start to section for KB on how to contribute to DJGPP
References: <3A4BA452 DOT BB6ADC3F AT bigfoot DOT com> <3A4CB0B3 DOT 9ADC93C AT softhome DOT net> <4331-Sun31Dec2000122524+0200-eliz AT is DOT elta DOT co DOT il> <20010110083821 DOT B24622 AT kendall DOT sfbr DOT org>
Reply-To: djgpp-workers AT delorie DOT com
Errors-To: nobody AT delorie DOT com
X-Mailing-List: djgpp-workers AT delorie DOT com
X-Unsubscribes-To: listserv AT delorie DOT com
Precedence: bulk


> What is a `Knowledge Base', and how should it differ from a `User's Guide'
> or from a hypothetical `DJGPP book'?  What are the reasons for having
> both the KB and the UG?  Would it be preferable to pull most everything
> together into a sort of "Hitchhiker's Guide to DJGPP"?

It's hard to describe.  The KB is kinda a distillation of information
about random topics, sorta like MS's KB.  You can put *anything* in
there just to keep track of it.  The UG is intended to be read by
beginners, but should eventually be all-inclusive.  The HOWTOs are
intended to be step-by-step instructions, very focused.

> These are not criticisms, but questions about the Right/Best Thing To Do
> with respect to djgpp documentation.  If someone were to donate effort to
> `djgpp documentation project', how would that effort best be spent?

As information grows, it needs to be collected and presented
differently.  The FAQ is now large enough that some of its entries
could become chapters in some other document, perhaps merged with
other sources.

If you want to work on documentation, I would suggest using the User's
Guide as the intended destination.  I know it won't go away (it's on
my server) and it has the most room for growth.

I suppose I should put the guide under CVS too, then, eh?