[aerogear-dev] do we want swagger for REST endpoint documentation?

[Heiko W.Rupp]

On 3 Apr 2015, at 18:53, Andrea Vibelli wrote:

> we are using it in Project Newcastle with annotations on the 
> endpoints, and
> it's really handy.

All the JBoss ON 3.2+ and RHQ REST-docs are generated from JAX-RS + 
Swagger annotations.
In Hawkular we are basically doing the same, but with a different 
annotation processor.

I personally think the best is really to have the annotations in the 
source and not trying
to update a separate .yml file, as the latter usually is much easier 
forgotten.