Re: [aerogear-dev] do we want swagger for REST endpoint documentation?
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.