Re: [Resteasy-developers] Javadoc-style JAX-RS documentation?

[Stef E. <st...@ep...>]

On Tue, Nov 18, 2008 at 08:11:01AM -0500, Bill Burke wrote:
> What do you mean?  Can you give an example?

This is JSF tag documentation:

http://www.jboss.org/file-access/default/members/jbossrichfaces/freezone/docs/tlddoc/index.html

And it's funny but I just cannot remember where I saw those
javadoc-style XML documentation. I'm pretty sure it was generated from
either XSD or JAXB...

What I mean is that we could have a doctlet which would collect all
resources available by path and create javadoc for each HTTP method.

As a trivial example, each resource path part would look like a javadoc
package, each end part a class, and each HTTP method an object method.

All this would be derived from more the JAX-RS annotation than the
implementation's Java structure.

-- 
Stéphane Epardaud