ecma262 icon indicating copy to clipboard operation
ecma262 copied to clipboard

Markup: rendering edits for 2025 edition & beyond

Open gesa opened this issue 6 months ago • 4 comments

This PR

  • Cleans up and improves comments on ECMA-262-specific print styles
  • Restores the (mandatory? i thought?) version line to metadata
  • Transforms 5 identical cells into one cell with rowspan 5 in table "Module fields after the initial Evaluate() call"
    • we made this change last year as well, I must have failed to push those changes back to main
  • Clarifies in the colophon that ecmarkup is used for Ecma specifications, not just ECMAScript specifications

gesa avatar Jun 11 '25 15:06 gesa

  • Transforms 5 identical cells into one cell with rowspan 5 in table "Module fields after the initial Evaluate() call"
    • we made this change last year as well, I must have failed to push those changes back to main

I'm going to complain just a little bit because I should have complained last year, but I don't really like it. They are 5 cells that happen to have the same value, not just a single cell.

nicolo-ribaudo avatar Jun 11 '25 22:06 nicolo-ribaudo

@nicolo-ribaudo That's totally legit. I think it's important to keep in the printable version (it's the only way all the text fits on the page) but I do not feel strongly—at all—about adding it to the web version, aka the actual source of truth.

gesa avatar Jun 12 '25 11:06 gesa

This looks fine for me on a small screen in the web version, not sure if changes for the print version are really needed:

image

linusg avatar Jun 25 '25 22:06 linusg

If the evaluating-async enum is not wrapping for print, maybe we could add a zero-width space to help encourage Prince?

michaelficarra avatar Jun 25 '25 22:06 michaelficarra

It's wrapping. The page just doesn't fit the table.

gesa avatar Jul 02 '25 21:07 gesa

If we renamed [[PendingAsyncDependencies]] to [[PendingAsyncDeps]], would it fit? Maybe that could be an option to consider.

nicolo-ribaudo avatar Jul 03 '25 09:07 nicolo-ribaudo