Simplifying single page Collections

Hi all!

Recently I was building some small AnnotationCollection objects--where pagination will (deliberately) not be used. I found example 40 confusing as it seems to express a requirement that an AnnotationPage inside `first` must be used. The `items` property is only mentioned (in the Web Annotation Data Model spec) as being related to AnnotationPage. However, the ActivityStreams vocabulary we "cribbed" these terms from have different ranges defined--i.e. CollectionPage extends Collection and `items` is defined on Collection.

Consequently, I think Example 40 sends the wrong message and I'd like to improve it (at least) via errata--and eventually via a spec version bump or a CG-based revision.

Example 40: https://www.w3.org/TR/annotation-model/#example-34
vs.
ActivityStreams 2.0 Collection definition and examples: https://www.w3.org/TR/activitystreams-core/#collections

That sound OK and like the right "revisioning" approach?

Cheers,
Benjamin

--

http://bigbluehat.com/

http://linkedin.com/in/benjaminyoung

Received on Monday, 16 September 2019 07:31:33 UTC