Skip to content

Draft Technical Report#30

Open
Ethan-Arrowood wants to merge 7 commits intomainfrom
technical-report
Open

Draft Technical Report#30
Ethan-Arrowood wants to merge 7 commits intomainfrom
technical-report

Conversation

@Ethan-Arrowood
Copy link
Copy Markdown
Collaborator

@Ethan-Arrowood Ethan-Arrowood commented Jan 20, 2026

Authors an ECMA Technical Report for the future of runtime-keys work.

Closes: #23


Note: this is still heavily WIP; you're welcome to leave feedback but please know I'm still actively working on certain parts. This will be discussed at upcoming WinterTC meetings (first one will be January 23rd), so please attend those if you want to participate in the discussion.

Copy link
Copy Markdown

@gesa gesa left a comment

Choose a reason for hiding this comment

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

Cloudflare's workerd is not ideal, it's too late to ask them to change that right?

<li><strong>Organization</strong> (required): The organization or individual responsible for the runtime</li>
<li><strong>Name</strong> (required): The human-readable name of the runtime</li>
<li><strong>Key</strong> (required): The unique string identifier</li>
<li><strong>Description</strong> (required): A brief description of the runtime</li>
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🤔 Should this use more precision than "brief" ? A maximum character length maybe? (similarly should all fields have a character length limit?)

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Also I think "required" is fine here, but if the secretariat raises any concerns, maybe we switch to "mandatory"?

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

Happy to make the switch if the secretariat raises a concern.

I'm indifferent on changing "brief". If someone has a compelling maximum character limit then I won't necessarily disagree, but I personally do not have a good idea for what that would be. Open to other wording suggestions as well.

@Ethan-Arrowood
Copy link
Copy Markdown
Collaborator Author

What is wrong with workerd? I think that is a unique enough key since it matches their actual runtime name: https://github.com/cloudflare/workerd

Contrary to worker or workers which I would absolutely agree is too ambiguous or general.

Copy link
Copy Markdown

@gesa gesa left a comment

Choose a reason for hiding this comment

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

For consistency, use TC55 when referring to the TC, and use WinterTC55 when referring to the GitHub org.

I am v excited about this TR. Now I need to write the ecmarkup to generate it as not-a-standard

@gesa
Copy link
Copy Markdown

gesa commented Mar 3, 2026

@Ethan-Arrowood Bringing your notes from my PR into this primary PR

  • Drop the word "conditions" from ~line 70
  • Spelling of "organization" to "organisation" in the JSON too
  • "Proposing entries for future editions" -> "Proposing new runtime key entries" ?
  • Add link to repo in proposal process steps
  • Fix some grammar in proposal process ~line 308 "The pull request is be formally approved..."
  • Add link to runtime-keys.json file (repo main branch or maybe commit at time of publish?) in the "Machine-readable canonical source" section

I'm deeply conflicted about the spelling of organisation within the JSON. Ecma does formally use Oxford GB English, but when it comes to code, designers have historically opted for en-US spellings.

Co-authored-by: Aki <hi@akiro.se>
@Ethan-Arrowood Ethan-Arrowood marked this pull request as ready for review April 3, 2026 16:44
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.

Future of Runtime Keys

4 participants