Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Editorial: update links to Ecma specs and update ECMA-402 descriptor #3103

Merged
merged 1 commit into from
Feb 14, 2024

Conversation

michaelficarra
Copy link
Member

@michaelficarra michaelficarra added editorial change editor call to be discussed in the next editor call labels Jun 20, 2023
ECMA-402, <i>ECMAScript 2015 Internationalization API Specification</i>.<br>
<a href="https://ecma-international.org/publications/standards/Ecma-402.htm">https://ecma-international.org/publications/standards/Ecma-402.htm</a>
ECMA-402, <i>ECMAScript Internationalization API Specification</i>.<br>
<a href="https://www.ecma-international.org/publications-and-standards/standards/ecma-402/">https://www.ecma-international.org/publications-and-standards/standards/ecma-402/</a>
Copy link
Member

Choose a reason for hiding this comment

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

should we maybe link to tc39.es instead of the yearly snapshot?

Copy link
Member

Choose a reason for hiding this comment

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

This was marked resolved, but without an explanation or an update?

Copy link
Member Author

@michaelficarra michaelficarra Jun 22, 2023

Choose a reason for hiding this comment

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

We should link to the Ecma page that lists the yearly releases so that the appropriate one can be chosen.

specifically the annual edition corresponding to this edition of this specification

Copy link
Member

Choose a reason for hiding this comment

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

They're both living standards - the appropriate one is only, and always, the one on tc39.es, imo.

Choose a reason for hiding this comment

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

I think we had this discussion already...

  1. There is only one TC39 Standard (ES20xx) that is currently approved by the Ecma GA year by year in their June meeting. This is what is reflected on the Ecma website, where you can access and download those standards. TC39 and the ECMA GA wish was (since 2016) to do this once per year (By the way, In theory one could go to two approvals per year, per GA, every 6 months. Theoretically, one could place letter ballot approvals in between it was needed. Theory, Ecma never did that). According to Ecma terms the actual Edition of ES20xx is the only valid standard.
  2. There are between the two Editions of ES20xx so called "Draft Standards". This just reflects work in progress, but they are not the formally approved Ecma standards, because formal approval is on the GA level by Ecma Ordinary Members. Draft standards - which are not voted by the GA - can be changed through the TC work any time both from the substance and the editorial point of view. This is what TC39 does. To call such "draft standards" as "living standards" to make the impression (and even declare it so) that the draft is already the formally approved standard is not a concept what the Ecma procedures support. Let alone two "living standards" in parallel, which are different.

Copy link
Member Author

Choose a reason for hiding this comment

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

@ljharb

@bakkot and I already discussed this and approved the current wording. Please merge as-is.

Copy link
Member

Choose a reason for hiding this comment

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

I don’t think this is solely an editorial concern.

@ecmageneva im aware of the ecma categorization, but the living standard on tc39.es is what the wider community considers the standard, and that’s what i think should be referenced here. It’s fine if the snapshot on ecma’s website is updated to point back at ecma’s website, ofc.

spec.html Show resolved Hide resolved
spec.html Show resolved Hide resolved
@bakkot
Copy link
Contributor

bakkot commented Jun 21, 2023

This section also should include IEEE-754.

@michaelficarra michaelficarra removed the editor call to be discussed in the next editor call label Jun 21, 2023
spec.html Show resolved Hide resolved
@ljharb ljharb merged commit 509620e into main Feb 14, 2024
8 checks passed
@ljharb ljharb deleted the ecma-spec-links branch February 14, 2024 02:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
editorial change es2024 to be landed before es2024 ready to merge Editors believe this PR needs no further reviews, and is ready to land.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

4 participants