search

w3c / sync-media-pub

Repository of the Synchronized Multimedia for Publications Community Group
http://w3c.github.io/sync-media-pub
Other
16 stars 4 forks source link

The `role` property in `sync` #38

Closed iherman closed 3 years ago

iherman commented 3 years ago

§3.3.1 introduces the role property. However, it is misleading, and it should be defined as sync:role; the same holds to its specification in the table of §3.3.2. Example 2 actually gets it right, but it is very unclear to the reader which one is correct.

B.t.w., a similar comment can be made for the introduction of the track element in §3.5.

marisademeglio commented 3 years ago

The story here is that the CG told me they would like to define the model first before moving onto serialization format(s).

Therefore, I tried to do a weird balancing act to keep the model definition generic and easily suited to both JSON and XML (so: no namespaces, use words like "node" and "property" instead of "element" and "attribute"), but of course for the examples, a format was required.

I do not know how long to wait for the CG to give feedback about the model before just making a decision myself on what to do. I don't think I should hold my breath here...