RE: W3C standardization process

Kevin,

You forgot to CC the list. I forwarded your mail. Comments inline.


On Friday, January 24, 2014 3:34 PM, Kevin Swiber wrote:
> On Fri, Jan 24, 2014 at 8:30 AM, Markus Lanthaler wrote:
> > On Thursday, January 23, 2014 9:09 PM, James Langley wrote: 
> > > Hydra gives us some nice features from a testing perspective - the
> > > "returns" feature allows us to validate our API output automatically,
> > > and we can re-use the same validation to apply to client-supplied data
> > > for the "expects" side of things. It also seems that we can use the
> > > same Hydra context as both our test blueprint and our developer
> > > documentation, which is nice.
> > 
> > Right, that's one of the unique selling points of Hydra I would say. I
> > discussed that in detail in the "Model Your Application Domain, Not Your
> > JSON Structures" paper [3].
> 
> I haven't read the paper yet, but the title sounds exactly like what
> I try to push in API design.  I'm looking forward to the read.

I would love to hear your thoughts on that paper.


> > > It also seems that we can pass better semantics back to the clients
> > > (to support i18n, l10n, and accessibility issues) than Siren allows.
> > 
> > Yep, you get that more or less for free.
> 
> Can you explain Hydra's benefit here?

JSON-LD has (just as RDF) internationalization support [1] built-in. It
allows you to associate a string with a language tag. Similarly, you are
able to type values [2] like distances etc. to specify their unit.


> Admittedly, I haven't had to deal with i18n or l10n support.

Here in Europe you don't come far without it :-P


> > > (Because you don't seem to be able to assign a Siren Class to a Siren
> > > Property, only to an Entity.) I plan to raise that on the Siren Google
> > > Group later.
> > 
> > You mean defining the "range" of a property? I thought that's possible
but
> > after re-checking the documentation I see it isn't. Apparently field
types
> > are limited to the input types specified by HTML5 [4-5].
> 
> Confirming this is correct.  I'll go into more depth on the Siren list.

Please CC this list if something relevant for Hydra is being discussed. It
would be interesting to see what it would take to align Hydra and Siren so
that you get the best of both.


Thanks,
Markus


[1] http://www.w3.org/TR/json-ld/#string-internationalization
[2] http://www.w3.org/TR/json-ld/#typed-values


--
Markus Lanthaler
@markuslanthaler

Received on Sunday, 26 January 2014 19:05:06 UTC