Re: [aerogear-dev] Documenting Server Side Interfaces

Hi Daniel, what do you think about the specification section? Like a new one to the server side here: http://aerogear.org/docs/specs/ -- "The measure of a man is what he does with power" - Plato - @abstractj - Volenti Nihil Difficile On Tuesday, November 6, 2012 at 12:35 PM, Daniel Bevenius wrote: > > I would say we just need error responses documented for all of the methods and also include 401 which would be returned if they are not authorized to access a secure endpoint no matter the method. > > Thanks Kris, I've added error response code to the doc. > > Any thoughts on where we should put this information? > Does it belong to the spec section or aerogear.org (http://aerogear.org), for example adding a section with the header "Server Side Specifications" and a "REST API" link? > > > > On 6 November 2012 14:04, Kris Borchers <kris(a)redhat.com <javascript:;>(mailto: kris(a)redhat.com <javascript:;>)> wrote: > > Dan, > > > > This looks really nice! I would say we just need error responses documented for all of the methods and also include 401 which would be returned if they are not authorized to access a secure endpoint no matter the method. > > > > Kris > > > > On Nov 6, 2012, at 6:55 AM, Daniel Bevenius <daniel.bevenius@gmail.com<javascript:;>(mailto: daniel.bevenius(a)gmail.com <javascript:;>)> wrote: > > > Hi! > > > > > > I've started to document the server side interfaces here: > > > https://gist.github.com/4023803 > > > > > > Let me know if you can think of things that are missing. > > > > > > Thanks, > > > > > > /Dan _______________________________________________ > > > aerogear-dev mailing list > > > aerogear-dev(a)lists.jboss.org <javascript:;> (mailto: aerogear-dev(a)lists.jboss.org <javascript:;>) > > > https://lists.jboss.org/mailman/listinfo/aerogear-dev > > > > > > > > _______________________________________________ > > aerogear-dev mailing list > > aerogear-dev(a)lists.jboss.org <javascript:;> (mailto: aerogear-dev(a)lists.jboss.org <javascript:;>) > > https://lists.jboss.org/mailman/listinfo/aerogear-dev > > > _______________________________________________ > aerogear-dev mailing list > aerogear-dev(a)lists.jboss.org <javascript:;> (mailto: aerogear-dev(a)lists.jboss.org <javascript:;>) > https://lists.jboss.org/mailman/listinfo/aerogear-dev _______________________________________________ aerogear-dev mailing list aerogear-dev(a)lists.jboss.org <javascript:;> https://lists.jboss.org/mailman/listinfo/aerogear-dev