w3c / epub-specs

Shared workspace for EPUB 3 specifications.
Other
305 stars 60 forks source link

Duplicative requirements for last modified date #2662

Open mattgarrish opened 1 month ago

mattgarrish commented 1 month ago

Issue on the EPUB 3.3 Recommendation

5.5.5 Last modified date

Describe the problem

The required pattern for the last modified date is stated in one paragraph to be:

YYYY-MM-DDThh:mm:ssZ

But in the very next paragraph we restate the requirements implied in the pattern:

EPUB creators MUST express the last modification date in Coordinated Universal Time (UTC) and MUST terminate it with the "Z" (Zulu) time zone indicator.

Describe the fix or new feature you propose

In the interests of not duplicating normative requirements, we could make the second paragraph an explanation of the pattern by removing the MUSTs:

The required "Z" (Zulu) time indicator at the end of the pattern means the last modification date is always expressed in Coordinated Universal Time (UTC).

(Or even make this a note.)

Edit: tweaked the proposed new wording a bit to remove a redundancy and fix a grammar error.

iherman commented 1 month ago

+1 as a Note