users@jersey.java.net

[Jersey] Re: Automatic documentation tool?

From: Matthieu Heimer <matt.heimer_at_osdev.org>
Date: Wed, 7 Aug 2013 14:58:53 -0500

You could look at one of the WADL to HTML tools. http://wadl.java.net/

On Wed, Aug 7, 2013 at 1:35 PM, Robert DiFalco <robert.difalco_at_gmail.com> wrote:
> Most everything I have looked at has either required me to double annotate
> stuff, add more data, or shows only minimal information.
>
> If seems to me that if I use POJO java beans for all my return values, path
> params, and query params and if the Resources and Beans are well javadoc'd
> that there should be a tool that can auto-generate very good documentation
> showing all the JSON as well as the resource paths and methods. This should
> be able to just run as a maven task scraping the annotations and parsing the
> beans to assemble JSON.
>
> Does anyone know if a tool like this exists?
>
> Thanks!
>
>