w3c / transitions

W3C Transitions
https://www.w3.org/Guide/transitions/
72 stars 30 forks source link

PR Request for EPUB 3.3, EPUB Reading Systems 3.3, and EPUB Accessibility 1.1 #484

Closed wareid closed 1 year ago

wareid commented 1 year ago

Document titles, URLs, estimated publication dates

Abstract

Status

Will new features be allowed to be incorporated in the Recommendation?

No.

Link to group's decision to request transition

Changes

Requirements satisfied

Quoting from the main requirements in the WG charter:

[…] the interoperability of EPUB 3 content, and the conformance of EPUB 3 reading systems, remain a serious issue. There is a need for a more rigorous and comprehensive testing of EPUB 3; this may also mean the need for a further clarification of the standard text itself. […] The EPUB 3 Working Group will advance, refine, and clarify the EPUB 3 standard to ensure its relevance as digital publishing continues to evolve, and specify a comprehensive testing environment for EPUB 3.

The WG has:

The WG believes that fully satisfied the requirement for the clarifications needed in the specification, as well as establishing a comprehensive testing environment.

Dependencies met (or not)

There were no major dependencies.

Wide Review

Horizontal reviews:

See horizontal review tracker.

The WG discussions were conducted through github issues. The group took over the repository used to develop earlier versions of EPUB, and that meant ≈100 open issues at the time the Working Group started (September 2020); some of those were around for years. During the lifetime of the Working Group ≈499 issues were added, coming both from the wider community and the Working Group itself, with the participation of experts outside the group.

Issues addressed

The change log items listing the substantial changes, i.e.:

include references to the issues that were addressed by those changes.

Formal Objections

None.

Implementation

The exit criteria of the Working Group are described in:

Reports of the testing and implementation results can be found here:

There are numerous EPUB 3 Reading System implementations on the market, some major ones are represented on the Working Group (Google, Apple, Kobo, EDRLab, VitalSource, Colibrio, etc.). We have received testing results from all of these participants, and more. Also, the group has numerous contacts with Publishers, as well as accessibility organizations, who have contributed to the CR testing of, e.g., vocabularies.

Finally, there is a strong cooperation between the Working Group and the developers of EPUBCheck, that already has a beta version of an EPUB 3.3 checker. (This is particularly important, because epubcheck is used by virtually all publishers before releasing a new publication.) You can find results of EPUBCheck testing here: https://w3c.github.io/epub-structural-tests/

Patent disclosures

Additional note on PR Transition

The Working Group's charter has a very strong clause on backwards compatibility:

Any existing valid EPUB 3.2 should remain valid under EPUB 3.X, unless it relies on features discovered to have serious issues (such as a security bug).

What this means that the usual CR approach, whereby if a feature does not get the right number of implementation per the exit criteria must be removed from the specification, cannot be applied in this case. Instead, the WG has introduced a special category called "under-implemented features" to mark those features in the final publication.

Only one feature was found during testing to require this category: https://www.w3.org/TR/epub-33/#attrdef-dir. We have kept this feature in due to its importance for i18n support.

plehegar commented 1 year ago

[[ The Working Group: [...]

I don't see any feature at risk listed in the last Candidate Recommendation Snapshot. Yet, the change log contains lots of substantive changes.

You need to follow 6.3.8.1. Publishing a [Candidate Recommendation Snapshot](https://www.w3.org/2021/Process-20211102/#candidate-recommendation-snapshot). This contains by reference the following requirement: "must show that the changes have received wide review.". Was there a wide review of the substantive changes done since the last Candidate Recommendation Snapshot?

plehegar commented 1 year ago

Closing. Will first need a transition request to CR Snapshot.

plehegar commented 1 year ago

APA and i18n are ok with the changes. waiting on checking with TAG and PING.

Once those checks are done, this will get published as a CR Snapshot.

plehegar commented 1 year ago

Waiting on TAG: https://lists.w3.org/Archives/Public/www-tag/2023Feb/0003.html

plehegar commented 1 year ago

Please, republish this document as a Candidate Recommendation Snapshot. It's fine to publish on the 21st.

plehegar commented 1 year ago

Documents have been republished as Snapshot, eg https://www.w3.org/TR/2023/CR-epub-33-20230221/

Feel to reopen this or submit a new one when ready to move to PR.