X-Authentication-Warning: kendall.sfbr.org: jeffw set sender to jeffw AT darwin DOT sfbr DOT org using -f
Date: Wed, 10 Jan 2001 08:38:21 -0600
From: JT Williams <jeffw AT darwin DOT sfbr DOT org>
To: djgpp-workers AT delorie DOT com
Subject: Re: Start to section for KB on how to contribute to DJGPP
Message-ID: <20010110083821.B24622@kendall.sfbr.org>
Mail-Followup-To: djgpp-workers AT delorie DOT com
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>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <4331-Sun31Dec2000122524+0200-eliz@is.elta.co.il>; from eliz@is.elta.co.il on Sun, Dec 31, 2000 at 12:25:25PM +0200
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

-: Large parts of the FAQ should actually be converted into the Knowledge
-: Base sections.  Feel free...

Could you elaborate?  For example, what are some sections of the FAQ
that you feel should be transferred to the KB?

More generally, I have wondered for several years about the goals of the
`djgpp documentation project', and also about the aborted `djgpp book
project' I see mentioned in the mail archives.

The current djgpp documentation is substantial, but IMHO it needs some
`organization'.  We have a fabulous FAQ, a Knowledge Base, a User's Guide,
various HowTo's and ReadMe's, tutorials, and so on.  We have a massive
mail archive that contains lots of useful information.  By and large,
it's all there, but fragmented and scattered.  Is there a long-term goal
(or wish) for integrating all this documentation?

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"?

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?

--
TIA/jtw