W3C home > Mailing lists > Public > public-script-coord@w3.org > April to June 2013

Request for JSON-LD API review (was: Coordination)

From: Markus Lanthaler <markus.lanthaler@gmx.net>
Date: Tue, 16 Apr 2013 17:30:57 +0200
To: <public-script-coord@w3.org>
Cc: <public-rdf-comments@w3.org>
Message-ID: <01cb01ce3ab7$65700770$30501650$@lanthaler@gmx.net>
Hi all,

I've followed the discussions about better coordination between W3C and TC39
with great interested. We are defining an API ourselves but none of us have
been aware of this mailing list till recently. So we did ask Robin in the
past to review our API which was very helpful [1] (thanks again Robin). Last
week the JSON-LD API spec went into Last Call and I would thus like to
kindly ask for reviews of the latest working draft.

The spec is available at http://www.w3.org/TR/json-ld-api/
(please make sure to send your comments (also) to
public-rdf-comments@w3.org)

A bit of background info:

After a short discussion with Robin we decided to use method overloading to
have the "callback" parameter always last while still having an optional
"options" parameter. We are aware of the fact this isn't allowed at the
moment and already raised an issue for WebIDL [2].

Boris Zbarsky already raised his concerns about this style as not being
"platform consistent" [3].

We also considered Futures but decided that introducing a normative
dependency to the DOM spec is not acceptable at this stage.


Thanks a lot,
Markus


[1] https://github.com/json-ld/json-ld.org/issues/200
[2] https://www.w3.org/Bugs/Public/show_bug.cgi?id=21640
[3] http://www.w3.org/2011/rdf-wg/track/issues/124



--
Markus Lanthaler
@markuslanthaler
Received on Tuesday, 16 April 2013 15:31:31 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 21:37:49 UTC