Mail Archives: djgpp-workers/2001/01/10/09:45:55
> 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?
- Raw text -