Skip to content

Conversation

@gesa
Copy link
Contributor

@gesa gesa commented Oct 8, 2025

Caution

This document currently normatively references TC54's VERS specification, which is not a standard, nor is it up for standardisation at this time. CLE cannot be accepted by the GA with this normative reference.

Aligns formatting of CLE more closely with the Ecma standard template. The associated PDF was compiled with ecmarkup@6715c1e (tc39/ecmarkup#661)

A complete list of editorial modifications:

  • capitalisation on title and all headers
    • please check carefully for any potentially proper headers that were inappropriately edited AND for unmodified headers that were mistaken for proper titles
  • set status to "standard"‡
  • add standard adoption info for upcoming Ecma GA
  • modify normative references overview paragraph to default (i believe editors are entitled to drop this modification)
  • reorder normative references to put Ecma standards first
    • TODO: references shall be edited to link to appropriate targets once standard numbers are assigned
  • add a pdf generation npm script (editors may wish to reject this change as well) (please let me know if this script necessarily cannot produce the appropriate content)
  • delete unused print styles
  • add style to allow page breaks in Annex A

‡ I recommend once this is merged that you create a new branch for the opt-out period, and change the metadata on the main branch back to status: draft as well as version: 2<sup>nd</sup> edition

Informative: a possibly-abridged list of ecmarkup changes

  • table & figure caption colour and punctuation (specifically in print output)
  • terms & definitions rendering
    • each term using untitled clauses and displayed on its own line
    • removal from table of contents
  • office address removed from front cover
  • render toc 3 levels deep instead of 2
  • remove "draft" copyright option

Comment on lines -69 to +13
status: draft
status: standard
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the way 262 handles this is that the candidate goes in its own branch, so "main" always says "draft", but it might be ideal if there was a way to tell ecmarkup "ignore the inline status and set it to 'standard'" so we can keep it as "draft" in main.

(iow, this change is fine and much easier than doing branch gymnastics, we'll figure it out later)

@stevespringett
Copy link
Member

@ljharb this PR still needs to be merged I believe, or was it superseded by a different one?

Copy link
Collaborator

@ljharb ljharb left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

rebased

@ljharb ljharb merged commit cee3155 into Ecma-TC54:main Nov 12, 2025
5 checks passed
@ljharb ljharb mentioned this pull request Nov 12, 2025
@gesa gesa deleted the publication-edits branch November 12, 2025 01:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants