Document JAX-RS services

[Francesco Chicchiriccò <il...@apache.org>]

Hi all (but especially the "CXF squad"),
what's the best practice for generating HTML pages from JAX-RS annotations?

Now that we have this in place it would be nice to put on the website 
such HTML pages, together with Javadocs.

Regards.

-- 
Francesco Chicchiriccò

ASF Member, Apache Syncope PMC chair, Apache Cocoon PMC Member
http://people.apache.org/~ilgrosso/

Re: Document JAX-RS services

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

Hi

We've just had a Swagger in CXF thread [1] where Swagger (finally 
confirmed to be working with CXF) and RestDoc have been mentioned.

Enunciate has been mentioned today/yesterday.

Other approaches likely work too, but as far as I'm concerned I'm quite 
keen to get an auto-generated WADL browse-able too and I'm hoping to get 
close enough to HTML like this one:

https://dev.twitter.com/docs/api/1.1

though I haven't started yet...

Cheers, Sergey




[1] http://cxf.547215.n5.nabble.com/Swagger-and-CXF-td5723874.html

On 19/03/13 15:20, Francesco Chicchiriccò wrote:
> Hi all (but especially the "CXF squad"),
> what's the best practice for generating HTML pages from JAX-RS annotations?
>
> Now that we have this in place it would be nice to put on the website
> such HTML pages, together with Javadocs.
>
> Regards.
>