Open frank-dspeed opened 2 years ago
Stage | Purpose | Entrance Criteria | Acceptance Signifies | Spec Quality At Entrance | Post-Acceptance Changes Expected | Implementation Types Expected* |
---|---|---|---|---|---|---|
0 | Allow input into the specification | None | N/A | N/A | N/A | N/A |
1 | Make the case for the additionDescribe the shape of a solutionIdentify potential challenges | Identified “champion” who will advance the additionProse outlining the problem or need and the general shape of a solutionIllustrative examples of usageHigh-level APIDiscussion of key algorithms, abstractions and semanticsIdentification of potential “cross-cutting” concerns and implementation challenges/complexityA publicly available repository for the proposal that captures the above requirements | The committee expects to devote time to examining the problem space, solutions and cross-cutting concerns | None | Major | Polyfills / demos |
2 | Precisely describe the syntax and semantics using formal spec language | AboveInitial spec text | The committee expects the feature to be developed and eventually included in the standard | Draft: all major semantics, syntax and API are covered, but TODOs, placeholders and editorial issues are expected | Incremental | Experimental |
3 | Indicate that further refinement will require feedback from implementations and users | AboveComplete spec textDesignated reviewers have signed off on the current spec textAll ECMAScript editors have signed off on the current spec text | The solution is complete and no further work is possible without implementation experience, significant usage and external feedback. | Complete: all semantics, syntax and API are completely described | Limited: only those deemed critical based on implementation experience | Spec compliant |
4 | Indicate that the addition is ready for inclusion in the formal ECMAScript standard | AboveTest262 acceptance tests have been written for mainline usage scenarios, and mergedTwo compatible implementations which pass the acceptance testsSignificant in-the-field experience with shipping implementations, such as that provided by two independent VMsA pull request has been sent to tc39/ecma262 with the integrated spec textAll ECMAScript editors have signed off on the pull request | The addition will be included in the soonest practical standard revision | Final: All changes as a result of implementation experience are integrated | None | Shipping |
Stage Purpose Entrance Criteria Acceptance Signifies Spec Quality At Entrance Post-Acceptance Changes Expected Implementation Types Expected*
0 Allow input into the specification None N/A N/A N/A N/A
1
Make the case for the addition
Describe the shape of a solution
Identify potential challenges
Identified “champion” who will advance the addition
Prose outlining the problem or need and the general shape of a solution
Illustrative examples of usage
High-level API
Discussion of key algorithms, abstractions and semantics
Identification of potential “cross-cutting” concerns and implementation challenges/complexity
A publicly available repository for the proposal that captures the above requirements
The committee expects to devote time to examining the problem space, solutions and cross-cutting concerns None Major Polyfills / demos
2 Precisely describe the syntax and semantics using formal spec language
Above
Initial spec text
The committee expects the feature to be developed and eventually included in the standard Draft: all major semantics, syntax and API are covered, but TODOs, placeholders and editorial issues are expected Incremental Experimental
3 Indicate that further refinement will require feedback from implementations and users
Above
Complete spec text
Designated reviewers have signed off on the current spec text
All ECMAScript editors have signed off on the current spec text
The solution is complete and no further work is possible without implementation experience, significant usage and external feedback. Complete: all semantics, syntax and API are completely described Limited: only those deemed critical based on implementation experience Spec compliant
4 Indicate that the addition is ready for inclusion in the formal ECMAScript standard
Above
Test262 acceptance tests have been written for mainline usage scenarios, and merged
Two compatible implementations which pass the acceptance tests
Significant in-the-field experience with shipping implementations, such as that provided by two independent VMs
A pull request has been sent to tc39/ecma262 with the integrated spec text
All ECMAScript editors have signed off on the pull request
The addition will be included in the soonest practical standard revision Final: All changes as a result of implementation experience are integrated None Shipping
Reach: https://github.com/tc39/how-we-work/blob/main/pr.md#stage-4-proposal-prs-normative