w3c / wpub

W3C Web Publications
https://w3c.github.io/wpub/
Other
78 stars 19 forks source link

Discrepancy between the spec and the canonical manifest on title #325

Closed iherman closed 6 years ago

iherman commented 6 years ago

The current text says, for title:

If not included in the manifest, user agents MAY use the value of the title element [html] of the Web Publication’s primary entry page (if present).

Whereas the first step in the canonical manifest algorithm re-uses the title element of the primary entry page in all cases if the name value is not in the manifest.

iherman commented 6 years ago

There is a note in the aforementioned section:

Relying on the title element could be semantically problematic if the Web Publication consists of several HTML resources (e.g., one per chapter of a book), because the HTML definition defines this element as "metadata" for the enclosing HTML document, not for a collection of resources. Using this element is, on the other hand, preferred in the case of a publication consisting of a single HTML document (e.g., a scholarly journal article).

I propose, to make things more interoperable, that

(This means the canonicalization must be updated, too)

iherman commented 6 years ago

Created a PR (#331) to make it clear what I propose

TzviyaSiegman commented 6 years ago

Discussion is at #331, therefore closing this issue