JAX-RS Doclet

[Michael Cheung <ch...@gmail.com>]

Does anyone know any goods tools to create REST documentation?  I only
found http://www.lunatech-labs.com/open-source/jax-doclets. I want to see if
anyone find a better tools. Please welcome to share your best practices.

Thanks,

Michael

Re: JAX-RS Doclet

[Sergey Beryozkin <sb...@progress.com>]

It does look like a neat idea.  CXF also gives you an option to use a Description[1] annotation

Note I was about to commit today the code which will let users get a source (proxy-based and then web client based) for a given 
endpoint generated on the fly and then retrieved as a zip file. But the the real intent is to offer users an option to do the 
WADL-first development (with the tooling support being offered later) but I'm afraid I'll have to postpone the merge for few days

cheers, Sergey

[1] http://svn.apache.org/repos/asf/cxf/trunk/rt/frontend/jaxrs/src/main/java/org/apache/cxf/jaxrs/ext/Description.java

----- Original Message ----- 
From: "Michael Cheung" <ch...@gmail.com>
To: <us...@cxf.apache.org>
Sent: Thursday, February 25, 2010 7:29 PM
Subject: JAX-RS Doclet


Does anyone know any goods tools to create REST documentation?  I only
found http://www.lunatech-labs.com/open-source/jax-doclets. I want to see if
anyone find a better tools. Please welcome to share your best practices.

Thanks,

Michael