IIIF / api

Source for API and model specifications documents (api and model)
http://iiif.io/api
106 stars 54 forks source link

`members`, `canvases`, `ranges`, `collections` to Linking properties & table #739

Closed jpstroop closed 8 years ago

jpstroop commented 8 years ago

These are only mentioned in later part of the spec. I think they should be treated like any other property, especially members since it's used twice.

azaroth42 commented 8 years ago

We don't discuss the structural properties at all in section 3.

The list seems like: collections, manifests, members, sequences, structures, canvases, resources, otherContent, images, ranges.

Not sure that 10 entries, most of which are just MUST on one resource type is worth the space?

azaroth42 commented 8 years ago

Would be okay with a Structural Properties table in Appendix B, rather than a full on block of 10 entries in section 3.

jpstroop commented 8 years ago

As discussed, I'd be willing to compromise on either adding them to the Linking table in Appendix B or adding a new Structure table there.

You should be able to go somewhere in the spec and get an overview of all of the properties we define. That's my goal.

azaroth42 commented 8 years ago

:+1:

azaroth42 commented 8 years ago

Added table: http://structural739.iiif.io/api/presentation/2.1/#b-summary-of-metadata-requirements

tomcrane commented 8 years ago

:+1: to the structural properties table. I may be years too late to the table with this, but are we happy with the symbols used? http://structural739.iiif.io/api/presentation/2.1/#b-summary-of-metadata-requirements. There is a world of difference between "optional" and "not allowed" and visually they get a bit lost in the structural table.

mikeapp commented 8 years ago

:+1: to the table. I agree with @tomcrane that the symbols could be improved. My instinctive reading of the red symbols is "not allowed!" - but of course the legend makes the meaning clear.

zimeon commented 8 years ago

:+1: to table, agree that optional symbol needs to stand out more

azaroth42 commented 8 years ago

Agree the symbols could be improved. Does someone have UI person cycles spare to work on that? Will create a separate issue...

zimeon commented 8 years ago

Easy way to improve optional symbol would be just to make it bolder/darker