users@jsr311.java.net

Re: documenting rest-interfaces

From: Marc Hadley <Marc.Hadley_at_Sun.COM>
Date: Tue, 29 Sep 2009 02:10:30 +0100

On Sep 28, 2009, at 11:03 AM, Reto Bachmann-Gmür wrote:
>
> I was wondering if somebody already wrote a tool to generate
> documentation of the rest-api from root-resource classes. The minimum
> would be to extends the javadoc to inlude the values of the relevant
> annotations.
>
Jersey generates a basic WADL description at runtime. It also has a
compile-time extension that extracts Javadoc and puts that into the
generated WADL too. An XSLT stylesheet is available to turn WADL into
HTML for browser consumption.

http://wikis.sun.com/display/Jersey/WADL

Marc.