- From: Randall Leeds <randall@bleeds.info>
- Date: Wed, 02 Sep 2015 20:33:04 +0000
- To: Robert Sanderson <azaroth42@gmail.com>, Web Annotation <public-annotation@w3.org>
- Message-ID: <CAAL6JQgmLdMiUTU+P8zWDd=NjRKS3uz1ysJXMidG_Ewp4UXw1Q@mail.gmail.com>
100% agree with the approach of reaching out to these communities. On Wed, Sep 2, 2015, 12:34 Robert Sanderson <azaroth42@gmail.com> wrote: > > A concern I have with the current proposed change to the JSON-LD context > is the mapping of @id and @type to id and type, respectively. > > Given just a single annotation, this poses no significant problem. When > compacting data according to the JSON-LD algorithm, it respects the id and > type definitions as expected. > > However, when we come to integrate annotations within other JSON-LD > systems, we run into potential issues. Notably, if we want to reuse the > Collections class [1] from ActivityStreams in the Social Web WG work, and > both contexts are provided, it will generate unexpected results. The same > would apply to any other use of our context in systems that did not also > make the mapping from @id to id.... or worse used id or type for something > other than the URI of the resource. > > [1] http://www.w3.org/TR/activitystreams-core/#collections > > For example, we have a requirement for collections of Annotations. In > order to use AS Collections, we would add our context document along with > theirs and expect to produce something like: > > { > "@context": ["http://www.w3.org/ns/activitystreams", " > http://www.w3.org/ns/oa.jsonld"], > "@id": "http://example.org/collection1", > "@type": "OrderedCollection", > "totalItems": 1000, > "orderedItems": [ > { > "id": "http://example.org/anno1", > "type": "Annotation", > "body": "Some comment", > "target": "http://www.example.com/index.html" > }, ... > ] > } > > But /actually/ our context would override the activitystreams context, and > the serialization would use "id" and "type" at the top level as well, where > JSON based AS consumers would not expect those keys. > > The context can be added at the Annotation level, however there is a known > issue that when compacting / expanding, the context will disappear. See > this thread: > > https://lists.w3.org/Archives/Public/public-linked-json/2014Jul/0011.html > > My proposal is to discuss this issue with the Social Web WG and the Linked > JSON Community Group, and see what the community at large thinks. And that > we should go with the broader consensus of what is best practice, rather > than potentially making a cosmetic change that has the unintended side > effect of limiting integration. > > I'm happy to start that conversation if you all think it would be valuable? > > Rob > > -- > Rob Sanderson > Information Standards Advocate > Digital Library Systems and Services > Stanford, CA 94305 >
Received on Wednesday, 2 September 2015 20:33:41 UTC