Doc: common howtos/docs (Was: [Bugs] URLSource)

[David Crossley <cr...@indexgeo.com.au>]

J.Pietschmann wrote:
> Stefano Mazzocchi wrote:
> > 
> > Many thanks for the clarification.
> > 
> > Ok, people, I'm sure there is some patching to do now :)
>
> It would be interesting whether there would be a project
> responsible for some "commonly used" documentation.
> For example:
>   - Understanding the Apache license :-)
>   - Understanding URIs and URLs
>   - Understanding the Java classpath and other common
>    Java related problems
> and the like.
> All these cause FAQs for all Apache projects I've watched.
> Instead of having each project answering this stuff for
> itself, it could be handled globally and only referenced
> by the project FAQs or included from a repository (the
> "short form"). Would this fit the Forrest project? Or
> Avalon or XML Commons? Or should some sort of "Apache
> encyclopedia" be spawned?
> 
> J.Pietschmann

(Sorry about my Cc of this thread, i am never sure what to do.)

You are right J. There is a stack of such common documentation
needed ... contributing, voting procedures, tips for new committers,
what the general mailing lists are and how to subscribe, ...

It sounds like something that should be on Forrest's dream list,
though Forrest seems to be running in circles.

I tried a thread on forrest-dev a while ago, but got no reply.
Re: Does Forrest intend to provide overview doco for all projects?
http://marc.theaimsgroup.com/?l=forrest-dev&m=101936135715629

--David