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

[Daniel Passos]

+1 for integration on the source code

On Fri, Apr 3, 2015 at 1:53 PM, Andrea Vibelli <avibelli at redhat.com> wrote:

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



-- 
-- Passos
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.jboss.org/pipermail/aerogear-dev/attachments/20150403/309ae928/attachment-0001.html