I agree 100% with what you say.
glassfish_at_javadesktop.org wrote:
> Actually, as a semi related comment.
>
> Not so much for a FAQ, but I think more "task oriented" documentation with common scenarios mapped out.
>
> As a simple example:
>
> "How do I add a JDBC connection pool". And the answer is simple "do this, this, and this, and here's an example, and here's where the files go". And not just the "here's what goes in the fields", but perhaps where those values comes from, and why they're needed.
>
> While there is good REFERENCE documentation, there isn't much organized TASK documentation, just scattered blogs. The reference docs just say "this is the JDBC class field", without really going in to perhaps regular vs XA classes, and such like that.
>
> Even if this was done in a Wiki, that would be good.
>
> The "How To Use Log4j" is a good example.
>
> That stuff shouldn't be living on a blog, but should be lifted (with permission) and centralized as a first class resource so the Blog author can Go Away as blogs are wont to do at times. Plus in a central space, they're more likely to be updated and perhaps tested to make sure they still work with the Latest McGreatest versions of the software.
> [Message sent by forum member 'whartung' (whartung)]
>
> http://forums.java.net/jive/thread.jspa?messageID=233576
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscribe_at_glassfish.dev.java.net
> For additional commands, e-mail: users-help_at_glassfish.dev.java.net
>
>