<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Fri, Apr 3, 2015 at 10:27 PM, Heiko W.Rupp <span dir="ltr"><<a href="mailto:hrupp@redhat.com" target="_blank">hrupp@redhat.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><span class="">On 3 Apr 2015, at 18:53, Andrea Vibelli wrote:<br>
<br>
> we are using it in Project Newcastle with annotations on the<br>
> endpoints, and<br>
> it's really handy.<br>
<br>
</span>All the JBoss ON 3.2+ and RHQ REST-docs are generated from JAX-RS +<br>
Swagger annotations.<br>
In Hawkular we are basically doing the same, but with a different<br>
annotation processor.<br></blockquote><div><br></div><div>+1000</div><div><br></div><div>we are, atm, doing similar:</div><div>source</div><div><a href="https://github.com/aerogear/aerogear-unifiedpush-server/blob/master/jaxrs/src/main/java/org/jboss/aerogear/unifiedpush/rest/sender/PushNotificationSenderEndpoint.java#L99-L102">https://github.com/aerogear/aerogear-unifiedpush-server/blob/master/jaxrs/src/main/java/org/jboss/aerogear/unifiedpush/rest/sender/PushNotificationSenderEndpoint.java#L99-L102</a><br></div><div>result:</div><div><a href="https://aerogear.org/docs/specs/aerogear-unifiedpush-rest/sender/index.html#POST">https://aerogear.org/docs/specs/aerogear-unifiedpush-rest/sender/index.html#POST</a><br></div><div><br></div><div>but the jaxrs doclet does not work w/ JDK8 - something has to change here ;-)<br></div><div>So, I am all for using Swagger annotations on the code to generate the HTML docs :-)<br></div><div><br></div><div>Greetings,</div><div>Matthias</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
<br>
I personally think the best is really to have the annotations in the<br>
source and not trying<br>
to update a separate .yml file, as the latter usually is much easier<br>
forgotten.<br>
<div class=""><div class="h5">_______________________________________________<br>
aerogear-dev mailing list<br>
<a href="mailto:aerogear-dev@lists.jboss.org">aerogear-dev@lists.jboss.org</a><br>
<a href="https://lists.jboss.org/mailman/listinfo/aerogear-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/aerogear-dev</a><br>
</div></div></blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature">Matthias Wessendorf <br><br>blog: <a href="http://matthiaswessendorf.wordpress.com/" target="_blank">http://matthiaswessendorf.wordpress.com/</a><br>sessions: <a href="http://www.slideshare.net/mwessendorf" target="_blank">http://www.slideshare.net/mwessendorf</a><br>twitter: <a href="http://twitter.com/mwessendorf" target="_blank">http://twitter.com/mwessendorf</a></div>
</div></div>