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

On Fri, Apr 3, 2015 at 10:27 PM, Heiko W.Rupp <hrupp(a)redhat.com&gt; wrote: > 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. > +1000 we are, atm, doing similar: source https://github.com/aerogear/aerogear-unifiedpush-server/blob/master/jaxrs... result: https://aerogear.org/docs/specs/aerogear-unifiedpush-rest/sender/index.ht... but the jaxrs doclet does not work w/ JDK8 - something has to change here ;-) So, I am all for using Swagger annotations on the code to generate the HTML docs :-) Greetings, Matthias > > 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. > _______________________________________________ > aerogear-dev mailing list > aerogear-dev(a)lists.jboss.org > https://lists.jboss.org/mailman/listinfo/aerogear-dev > -- Matthias Wessendorf blog: http://matthiaswessendorf.wordpress.com/ sessions: http://www.slideshare.net/mwessendorf twitter: http://twitter.com/mwessendorf _______________________________________________ aerogear-dev mailing list aerogear-dev(a)lists.jboss.org https://lists.jboss.org/mailman/listinfo/aerogear-dev