IIIF/api

All ordered lists should be `items`

azaroth42 opened this issue ยท 9 comments

If we are moving to collection.members and range.members, should we also rename canvases on Sequence?

Further, as we are moving to the Activity Streams pattern for Annotation Lists per https://www.w3.org/TR/annotation-model/#annotation-page and #496 ... I think we should actually use items to be consistent throughout.

In other words:

{
  "type": "Collection",
  "items": [
    {
      "type": "Manifest",
      "items": [
        {
          "type": "Sequence",
          "items": [
            {
              "type": "Canvas",
              "items": [
                {
                  "type": "AnnotationPage",
                  "items": [
                    {
                      "type": "Annotation"

Is it confusing, inconsistent, or worse that AnnotationPage objects can be in the items lists of both Canvas and AnnotationCollection (previously known as Layer)?

I was +1 to the idea of items everywhere, but now I'm wondering if the intent conveyed by terms like content, to associate a canvas with its content, is more important as an aid to understanding what is going on than the consistency of using the same term to associate resources with AnnotationPage (and other resources) throughout. I'm not -1 though.

c.f. #1068 -- is the set of annotationpages for a Canvas items and the set of AnnotationPages on everything else annotations?

I am now ๐Ÿ‘ as it resolves a difficult naming problem elsewhere.

However, even though we're still in alpha, the term content is now familiar to many people from the Presentation 3 work.

So I will email iiif-discuss to explain the proposed naming, ahead of Toronto.

๐Ÿ‘ agreed at Toronto WG meeting

Done, and duplicate of the renaming issue: http://prezi3.iiif.io/api/presentation/3.0/#items

๐Ÿ‘ agree done (and nice intro text)

๐Ÿ‘ also agree done, closing