18 Matching Annotations
  1. Sep 2018
    1. The epub:type attribute [ContentDocs32] is REQUIRED

      Discerning the available values of epub:type is a tangle... The referenced epub:type related section in the ContentDocs32 document references the Vocabulary Association paragraph which in turn references the Vocabulary Association Mechanisms section within this current document. From that section the default vocabulary can/may be found, but there is no reference there (or in any of these other sections) to the available epub:type values nor to their "meaning"/value to the author or implementer.

      However, just below this in the example (and above in relation to pagebreak there is a link directly to the defining defaults in the EPUB-SSV.

      It would be helpful for authors and implementers to know first about the SSV list, and then about the ability to extend the vocabulary.

    2. The toc nav element

      This makes it sound like there is an HTML element with a tag name of <toc nav> rather than <nav epub:type="toc"> (which seems to be what's intended).

      The landmarks example farther down is clearer--though the wording there of "the landmark nav element" is equally confusing.

      There remains only a nav element, but of varying types.

    3. In the context of this specification, the default display style of list items within nav elements MUST be equivalent to the list-style: none property [CSSSnapshot].

      This line is confusing because the actor (author or reading system) is unclear. The following two lines are much clearer on what actor is being restricted by this specification.

      This line feels specific to the Reading System requirements. Consequently, perhaps it's best to integrate it into the sentence just following.

    4. If an a or span element contains instances of HTML embedded content that do not provide intrinsic text alternatives, the element MUST also include a title attribute with an alternate text rendering of the link label.

      This requirement is clearer than the one just previous and also seems to obviate the earlier one.

      However, this one is confusing limiting the textual expression to just the title attribute, and also being vague of which element is associated to the MUST--is it this surrounding a or span? or the contained "embedded content" element?