api icon indicating copy to clipboard operation
api copied to clipboard

Note difference between total (prezi/wadm) and totalItems (discovery/as2)

Open azaroth42 opened this issue 3 years ago • 4 comments

For AnnotationCollection and AnnotationPage, we inherit the definitions from the web annotation data model, which is built on top of the ActivityStreams model, but creates some AnnotationSpecific terminology. In particular, WADM uses total instead of totalItems as the items are all Annotations, and it doesn't talk about "items" anywhere else. Discovery, on the other hand, is not about annotations, and reuses the base ActivityStreams term of totalItems.

Now we come to search. Search is intended to be used directly with Presentation, as it's about searches for annotations. Thus we should continue to use total, despite the discrepancy with Change Discovery.

Propose that we put in a warning to this effect to search 2.0 in section 3.2.2

azaroth42 avatar Mar 29 '22 18:03 azaroth42