10 a.m.
On Tue, 18 Jun 2013 16:26:26 +0200
Sebastien Blanc <scm.blanc(a)gmail.com> wrote:
+9006
And we should check that the integrations tests are always in sync with the
cookbook (use the same use cases / data) .
Asciidoc provides a nice feature of including snippets of code from real
files into documentation. Not sure if that would be possible with making groovy
syntax for integration tests nicely fitting cookbook syntax, but might be worth
investigating ;-)
Seb
On Tue, Jun 18, 2013 at 1:54 PM, Matthias Wessendorf <matzew(a)apache.org>wrote:
>
>
>
> On Tue, Jun 18, 2013 at 1:46 PM, Karel Piwko <kpiwko(a)redhat.com> wrote:
>
>> On Wed, 12 Jun 2013 10:22:10 +0200
>> Matthias Wessendorf <matzew(a)apache.org> wrote:
>>
>> > Hi,
>> >
>> > a little doc about the REST endpoints:
>> > https://gist.github.com/matzew/73ec38d853863e7bb1dd
>>
>> Extremely helpful, thanks! I wish I'd found it before I was wondering why
>> unified push server started returning 201 instead of 200.
>>
>> >
>> > I _think_ it would be nice IF the above "REST APIs" are also
describing
>> the
>> > "params" and HTTP headers that are required.
>> >
>> > These are currently (at least for sending) described in here:
>> > http://staging.aerogear.org/docs/specs/aerogear-push-messages/
>> >
>> > What do you think?
>> > Should we merge the "message format" spec with the "Sender
REST-API"
>> > endpoint documentation?
>>
>> Wouldn't they make a nice cookbook together if merged?
>>
>
> +1000
>
> I am currently on some security work, but I plan to merge the "message
> format + REST API"
>
> I think in three different "chapters"
> * REST Management APIs (for creating PushApplication / Variant) (+ crud
> workflow -> basically all used by the (future) Admin UI)
> * REST Auth Endpoint (Login/Logout and "enroll")
> * REST Sender (for sending push messages)
> * REST "Device Registration" (for the MobileVariantInstances (aka
> Installations))
>
> That ensure the doc is not too long.....
>
>
>
>
>>
>> >
>> > Also, if we do the merge.... I'd update the above gist to include
other
>> > values/headers/params for the
>> > MobileVariant/PushApplication/Installation(aka MobileVariantInstance) as
>> > well
>> >
>> > -Matthias
>> >
>>
>> _______________________________________________
>> aerogear-dev mailing list
>> aerogear-dev(a)lists.jboss.org
>> https://lists.jboss.org/mailman/listinfo/aerogear-dev
>>
>
>
>
> --
> Matthias Wessendorf
>
> blog: http://matthiaswessendorf.wordpress.com/
> sessions: http://www.slideshare.net/mwessendorf
> twitter: http://twitter.com/mwessendorf
>
> _______________________________________________
> aerogear-dev mailing list
> aerogear-dev(a)lists.jboss.org
> https://lists.jboss.org/mailman/listinfo/aerogear-dev
>