<div dir="ltr">+1 for integration on the source code</div><div class="gmail_extra"><br><div class="gmail_quote">On Fri, Apr 3, 2015 at 1:53 PM, Andrea Vibelli <span dir="ltr">&lt;<a href="mailto:avibelli@redhat.com" target="_blank">avibelli@redhat.com</a>&gt;</span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hi Stefan,<br>
we are using it in Project Newcastle with annotations on the endpoints, and<br>
it&#39;s really handy.<br>
So +1 for integration on the source code :)<br>
<br>
Andrea<br>
<br>
<br>
<br>
<br>
Stefan Miklosovic wrote<br>
<span class="">&gt; Do we need just that yaml or we want to integrate it directly into the<br>
&gt; source code with this? (1)  By doing this you can just point your<br>
&gt; browser to some url and it is generated dynamically.<br>
&gt;<br>
&gt; Or I just write that yaml, the disadvantage is that you have to update<br>
&gt; it every time some REST API changes to reflect it however I hesitate<br>
&gt; to touch sources, they should not know about this.<br>
&gt;<br>
&gt; (1) <a href="https://github.com/swagger-api/swagger-core/wiki/Java-JAXRS-Quickstart" target="_blank">https://github.com/swagger-api/swagger-core/wiki/Java-JAXRS-Quickstart</a><br>
&gt;<br>
</span>&gt; On Fri, Apr 3, 2015 at 2:18 PM, Daniel Passos &amp;lt;<br>
<br>
&gt; dpassos@<br>
<br>
&gt; &amp;gt; wrote:<br>
&gt;&gt; +9001<br>
&gt;&gt;<br>
&gt;&gt; On Fri, Apr 3, 2015 at 8:12 AM, Sebastien Blanc &amp;lt;<br>
<br>
&gt; scm.blanc@<br>
<span class=""><br>
&gt; &amp;gt; wrote:<br>
&gt;&gt;&gt;<br>
&gt;&gt;&gt; +1<br>
&gt;&gt;&gt; feels free to PR this<br>
&gt;&gt;&gt;<br>
</span>&gt;&gt;&gt; On Fri, Apr 3, 2015 at 1:10 PM, Matthias Wessendorf &amp;lt;<br>
<br>
&gt; matzew@<br>
<br>
&gt; &amp;gt;<br>
<span class="">&gt;&gt;&gt; wrote:<br>
&gt;&gt;&gt;&gt;<br>
&gt;&gt;&gt;&gt; that is very cool!<br>
&gt;&gt;&gt;&gt;<br>
&gt;&gt;&gt;&gt; Also this helps to retire the jaxrs doclet, that is not working w/ jdk8<br>
&gt;&gt;&gt;&gt;<br>
&gt;&gt;&gt;&gt;<br>
</span>&gt;&gt;&gt;&gt; On Friday, April 3, 2015, Karel Piwko &amp;lt;<br>
<br>
&gt; kpiwko@<br>
<span class=""><br>
&gt; &amp;gt; wrote:<br>
&gt;&gt;&gt;&gt;&gt;<br>
&gt;&gt;&gt;&gt;&gt; I really like the idea!<br>
&gt;&gt;&gt;&gt;&gt;<br>
</span>&gt;&gt;&gt;&gt;&gt; On Fri, Apr 3, 2015 at 11:06 AM, Stefan Miklosovic &amp;lt;<br>
<br>
&gt; smikloso@<br>
<br>
&gt; &amp;gt;<br>
<span class="">&gt;&gt;&gt;&gt;&gt; wrote:<br>
&gt;&gt;&gt;&gt;&gt;&gt;<br>
&gt;&gt;&gt;&gt;&gt;&gt; Hello,<br>
&gt;&gt;&gt;&gt;&gt;&gt;<br>
&gt;&gt;&gt;&gt;&gt;&gt; Is there any interest to describe REST API for UPS in a Swagger?<br>
&gt;&gt;&gt;&gt;&gt;&gt; (1),(2)<br>
&gt;&gt;&gt;&gt;&gt;&gt;<br>
&gt;&gt;&gt;&gt;&gt;&gt; I can imagine it would be pretty handy for folks, it is just one yaml<br>
&gt;&gt;&gt;&gt;&gt;&gt; file to write really.<br>
&gt;&gt;&gt;&gt;&gt;&gt;<br>
&gt;&gt;&gt;&gt;&gt;&gt; It could be somehow linked in UPS web page, swagger is just pure html<br>
&gt;&gt;&gt;&gt;&gt;&gt; + js without any dependencies at all.<br>
&gt;&gt;&gt;&gt;&gt;&gt;<br>
&gt;&gt;&gt;&gt;&gt;&gt; (1) <a href="http://swagger.io/" target="_blank">http://swagger.io/</a><br>
&gt;&gt;&gt;&gt;&gt;&gt; (2) <a href="http://petstore.swagger.io/#!/pet/deletePet" target="_blank">http://petstore.swagger.io/#!/pet/deletePet</a><br>
&gt;&gt;&gt;&gt;&gt;&gt;<br>
&gt;&gt;&gt;&gt;&gt;&gt; --<br>
&gt;&gt;&gt;&gt;&gt;&gt; Stefan Miklosovic<br>
&gt;&gt;&gt;&gt;&gt;&gt; Red Hat Brno - JBoss Mobile Platform<br>
&gt;&gt;&gt;&gt;&gt;&gt;<br>
&gt;&gt;&gt;&gt;&gt;&gt; e-mail:<br>
<br>
&gt; smikloso@<br>
<br>
</span><span class="">&gt;&gt;&gt;&gt;&gt;&gt; irc: smikloso<br>
&gt;&gt;&gt;&gt;&gt;&gt; _______________________________________________<br>
&gt;&gt;&gt;&gt;&gt;&gt; aerogear-dev mailing list<br>
&gt;&gt;&gt;&gt;&gt;&gt;<br>
<br>
</span>&gt; aerogear-dev@.jboss<br>
<span class=""><br>
&gt;&gt;&gt;&gt;&gt;&gt; <a href="https://lists.jboss.org/mailman/listinfo/aerogear-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/aerogear-dev</a><br>
&gt;&gt;&gt;&gt;&gt;<br>
&gt;&gt;&gt;&gt;&gt;<br>
&gt;&gt;&gt;&gt;<br>
&gt;&gt;&gt;&gt;<br>
&gt;&gt;&gt;&gt; --<br>
&gt;&gt;&gt;&gt; Sent from Gmail Mobile<br>
&gt;&gt;&gt;&gt;<br>
&gt;&gt;&gt;&gt; _______________________________________________<br>
&gt;&gt;&gt;&gt; aerogear-dev mailing list<br>
&gt;&gt;&gt;&gt;<br>
<br>
</span>&gt; aerogear-dev@.jboss<br>
<span class=""><br>
&gt;&gt;&gt;&gt; <a href="https://lists.jboss.org/mailman/listinfo/aerogear-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/aerogear-dev</a><br>
&gt;&gt;&gt;<br>
&gt;&gt;&gt;<br>
&gt;&gt;&gt;<br>
&gt;&gt;&gt; _______________________________________________<br>
&gt;&gt;&gt; aerogear-dev mailing list<br>
&gt;&gt;&gt;<br>
<br>
</span>&gt; aerogear-dev@.jboss<br>
<span class=""><br>
&gt;&gt;&gt; <a href="https://lists.jboss.org/mailman/listinfo/aerogear-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/aerogear-dev</a><br>
&gt;&gt;<br>
&gt;&gt;<br>
&gt;&gt;<br>
&gt;&gt;<br>
&gt;&gt; --<br>
&gt;&gt; -- Passos<br>
&gt;&gt;<br>
&gt;&gt; _______________________________________________<br>
&gt;&gt; aerogear-dev mailing list<br>
&gt;&gt;<br>
<br>
</span>&gt; aerogear-dev@.jboss<br>
<span class=""><br>
&gt;&gt; <a href="https://lists.jboss.org/mailman/listinfo/aerogear-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/aerogear-dev</a><br>
&gt;<br>
&gt;<br>
&gt;<br>
&gt; --<br>
&gt; Stefan Miklosovic<br>
&gt; Red Hat Brno - JBoss Mobile Platform<br>
&gt;<br>
&gt; e-mail:<br>
<br>
&gt; smikloso@<br>
<br>
</span><span class="">&gt; irc: smikloso<br>
&gt; _______________________________________________<br>
&gt; aerogear-dev mailing list<br>
<br>
</span>&gt; aerogear-dev@.jboss<br>
<br>
&gt; <a href="https://lists.jboss.org/mailman/listinfo/aerogear-dev" target="_blank">https://lists.jboss.org/mailman/listinfo/aerogear-dev</a><br>
<br>
<br>
<br>
<br>
<br>
--<br>
View this message in context: <a href="http://aerogear-dev.1069024.n5.nabble.com/aerogear-dev-do-we-want-swagger-for-REST-endpoint-documentation-tp11342p11356.html" target="_blank">http://aerogear-dev.1069024.n5.nabble.com/aerogear-dev-do-we-want-swagger-for-REST-endpoint-documentation-tp11342p11356.html</a><br>
Sent from the aerogear-dev mailing list archive at Nabble.com.<br>
<div class="HOEnZb"><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"><br>-- <br><div class="gmail_signature"><div dir="ltr">-- Passos<br></div></div>
</div>