[web-annotation] Annotation Lists

azaroth42 has just created a new issue for 
https://github.com/w3c/web-annotation:

== Annotation Lists ==

Several downstream systems have a need for lists of annotations, 
including EPUB [1] and IIIF [2].  For search, we need to have a list 
of annotations for the result set of applying the query to the set of 
annotations.  Other expressed use cases are user constructed 
"playlists" of Annotations, curated distribution lists of annotations,
 and general optimization of annotation retrieval to avoid thousands 
of HTTP calls for each annotation individually.

As an initial proposal, we could use Activity-Streams's 
`OrderedCollection` class[3], which seems to fulfill the (implicit, to
 be expressed) requirements:

```
{
  "@context": ["http://www.w3.org/ns/activitystreams", 
"http://www.w3.org/ns/oa"],
  "@type": "OrderedCollection",
  "totalItems": 10,
  "itemsPerPage": 1,
  "next": "http://example.org/foo?page=2",
  "self": "http://example.org/foo?page=1",
  "startIndex": 0,
  "orderedItems": [
    {
      "@type": "Annotation",
      "motivation": "commenting",
      "body": {"value": "I like this!"},
      "target": "http://www.cnn.com/"
    }
  ]
}
```

This would be consistent with a (to-be-proposed) use of AS2.0 for 
notifications about annotation activity.

[1] http://www.idpf.org/epub/oa/#h.48f1o3s9o9hf
[2] http://iiif.io/api/presentation/2.0/#other-content-resources
[3] http://www.w3.org/TR/activitystreams-core/#collections


See https://github.com/w3c/web-annotation/issues/50

Received on Tuesday, 7 July 2015 16:03:32 UTC