[aerogear-dev] Documenting Server Side Interfaces

[Daniel Bevenius]

Yeah, that sounds like a good place. I hope to do this tomorrow.

On Wednesday, 7 November 2012, Bruno Oliveira wrote:

> 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 at redhat.com <javascript:;>(mailto:
> kris at 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 at gmail.com<javascript:;>(mailto:
> daniel.bevenius at 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 at lists.jboss.org <javascript:;> (mailto:
> aerogear-dev at lists.jboss.org <javascript:;>)
> > > > https://lists.jboss.org/mailman/listinfo/aerogear-dev
> > >
> > >
> > >
> > > _______________________________________________
> > > aerogear-dev mailing list
> > > aerogear-dev at lists.jboss.org <javascript:;> (mailto:
> aerogear-dev at lists.jboss.org <javascript:;>)
> > > https://lists.jboss.org/mailman/listinfo/aerogear-dev
> >
> >
> > _______________________________________________
> > aerogear-dev mailing list
> > aerogear-dev at lists.jboss.org <javascript:;> (mailto:
> aerogear-dev at lists.jboss.org <javascript:;>)
> > https://lists.jboss.org/mailman/listinfo/aerogear-dev
>
>
>
> _______________________________________________
> aerogear-dev mailing list
> aerogear-dev at lists.jboss.org <javascript:;>
> https://lists.jboss.org/mailman/listinfo/aerogear-dev
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.jboss.org/pipermail/aerogear-dev/attachments/20121107/c211bd01/attachment.html