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

[azaroth42]

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

[zimeon]

Suspect intention was to put a note in 3.3.2 (https://preview.iiif.io/api/search-v3-alignment/search/2.0/#paging-results) rather than 3.2.2

[zimeon]

I'm not sure it is helpful to add such a note. To do so is to assume that someone is reading the the search spec with Activity Streams in their head. We don't mention Activity Streams and instead base the search spec on notions from Prezi. Prezi talks about its basis in WADM.

[zimeon]

Editors' meeting 2022-06-28: We want to use total to remain consistent with WADM. We decided not to add a note to Search 2.0.

[azaroth42]

Reopening for 4.0, where the list of properties is separated out. I think under total we put in the note about totalItems. This becomes more relevant now as we've re-added CollectionPage, rather than just AnnotationPage.