users@jaxb.java.net

Re: JAXB documentation needs some overhaul?

From: Kohsuke Kawaguchi <Kohsuke.Kawaguchi_at_Sun.COM>
Date: Mon, 30 Jul 2007 13:48:27 -0700

Wagle, Shriniwas wrote:
> Having played with JAXB for some, I'm impressed that it was able to
> handle some really complex schemas quite well.
>
> However now that I have been browsing the available JAXB documentation
> for some time now, thought I'd share with the community my experience:
> 1. Good documentation was hard to find.
> 2. Documentation currently seems to be a collection of articles and
> faqs, blogs etc. which address lots of issues but don't come across as
> comprehensive enough.

My current effort is to build up https://jaxb.dev.java.net/guide/ based
on interactions with users.

> 3. Some documentation is just not right (may be it is just dated).
> 3. I think that the JAXB product is quite important and feels robust
> now. So might be a time to gift wrap it such that people love it?

I agree the important of the documentation.

-- 
Kohsuke Kawaguchi
Sun Microsystems                   kohsuke.kawaguchi_at_sun.com