HTML Ruby Markup Extensions 2024-05-23 > 2024-06-27

[frivoal]

Name of your specification

HTML Ruby Markup Extensions

URL of your specification

https://www.w3.org/TR/2024/WD-html-ruby-extensions-20240523/

Does your specification include an Internationalization Considerations section?

• My specification includes an Internationalization Considerations section

When does the review need to be finished?

No specific date has been decided, but significant changes are not anticipated before CR, and there exist some implementations, so absent new problematic feedback, we may be in a good shape for moving to and beyond CR before long.

What has changed since any previous review?

The spec had been discontinued for some years, so any review is at this point ancient. Should be reviewed from scratch.

Please point to the results of your own self-review

w3c/html-ruby#14

Where and how should the i18n WG raise issues?

Please open individual issues in https://github.com/w3c/html-ruby/issues

Pointer to any explainer for the spec

No response

Other comments

The spec is intended to contain its own explainer. Specifically:

• https://www.w3.org/TR/html-ruby-extensions/#intro gives a general intro to the problem space
• https://www.w3.org/TR/html-ruby-extensions/#relations gives an high level overview of how this relates to the HTML spec
• https://www.w3.org/TR/html-ruby-extensions/#diff-html gets into the specifics of the motivations for proposing changes to the HTML model
• The spec has numerous examples. In particular, https://www.w3.org/TR/html-ruby-extensions/#ruby-compound is an author-centric non-normative section focused on illustrating both how you're supposed to use the markup patterns the spec defines and enables, and why you'd want to.

Further, this somewhat old but still relevant blog post covers the why and the what of this design quite extensively: https://fantasai.inkedblade.net/weblog/2011/ruby/

The i18n WG and IG themselves have produced numerous documents over the years that can serve as explainers for ruby, including for the features defined in this specification. https://www.w3.org/International/articles/ruby/markup.en is particularly relevant.