Readme & doc changes for Stage 3

tc39 · Mar 11, 2021 · 92da557 · 92da557
1 parent 3fe5d06
commit 92da557
Show file tree

Hide file tree

Showing 3 changed files with 19 additions and 23 deletions.
diff --git a/README.md b/README.md
@@ -6,29 +6,24 @@ Provides standard objects and functions for working with dates and times.
 
 ## Champions
 
--   Philipp Dunkel ([@pipobscure](https://github.com/pipobscure))
--   Maggie Johnson-Pint ([@maggiepint](https://github.com/maggiepint))
--   Matt Johnson-Pint ([@mattjohnsonpint](https://github.com/mattjohnsonpint))
--   Brian Terlson ([@bterlson](https://github.com/bterlson))
--   Shane Carr ([@sffc](https://github.com/sffc))
--   Ujjwal Sharma ([@ryzokuken](https://github.com/ryzokuken))
--   Philip Chimento ([@ptomato](https://github.com/ptomato))
--   Jason Williams ([@jasonwilliams](https://github.com/jasonwilliams))
--   Justin Grant ([@justingrant](https://github.com/justingrant))
+- Philipp Dunkel ([@pipobscure](https://github.com/pipobscure))
+- Maggie Johnson-Pint ([@maggiepint](https://github.com/maggiepint))
+- Matt Johnson-Pint ([@mattjohnsonpint](https://github.com/mattjohnsonpint))
+- Brian Terlson ([@bterlson](https://github.com/bterlson))
+- Shane Carr ([@sffc](https://github.com/sffc))
+- Ujjwal Sharma ([@ryzokuken](https://github.com/ryzokuken))
+- Philip Chimento ([@ptomato](https://github.com/ptomato))
+- Jason Williams ([@jasonwilliams](https://github.com/jasonwilliams))
+- Justin Grant ([@justingrant](https://github.com/justingrant))
 
 ## Status
 
-This proposal is currently [Stage 2](https://github.com/tc39/proposals#stage-2).
+This proposal is currently [Stage 3](https://github.com/tc39/proposals#stage-3).
+Stage 3 reviewers were: Richard Gibson, Bradley Farias, and Daniel Ehrenberg.
 
-At the time of writing, all the major design decisions that we are aware of have been made.
-The proposal is under review by the TC39 delegates and the bar for making subsequent changes is high.
-Nonetheless, changes may occur as the result of feedback from TC39 reviews and implementation in JS engines.
-
-Stage 3 Reviewers:
-
--   Richard Gibson
--   Bradley Farias
--   Daniel Ehrenberg
+This proposal is now in the hands of ECMAScript engine implementers, so the bar for making API changes is extremely high.
+Nonetheless, changes may occur as the result of feedback from implementation in JS engines.
+Editorial changes to the spec and bug fixes to the spec, polyfill, tests, and docs are also ongoing, as is customary for Stage 3 proposals.
 
 ## Overview / Motivation
 
@@ -54,7 +49,7 @@ A complete polyfill can be found [here](./polyfill).
 When viewing the [reference documentation](https://tc39.es/proposal-temporal/docs/index.html), the polyfill is automatically loaded in your browser, so you can try it out by opening your browser's developer tools.
 
 **NOTE:** We encourage you to experiment with the polyfill, but don't use it in production!
-The API may change before the proposal reaches Stage 3.
+The API may change based on feedback from implementers.
 
 ## Documentation
 

diff --git a/docs/head.html.part b/docs/head.html.part
@@ -137,7 +137,6 @@
   </head>
   <body>
     <div class="banner">
-      This proposal is <strong><a href="https://blogs.igalia.com/compilers/2020/06/23/dates-and-times-in-javascript/">experimental.</a></strong>
-      It is being reviewed by TC39.
+      This Stage 3 proposal is <strong><a href="https://blogs.igalia.com/compilers/2020/06/23/dates-and-times-in-javascript/">experimental.</a></strong>
       <strong>Do</strong> try it out and <a href="https://github.com/tc39/proposal-temporal/issues">report bugs</a>; <strong>don't</strong> use it in production!
     </div>
diff --git a/polyfill/README.md b/polyfill/README.md
@@ -3,7 +3,7 @@
 **Polyfill for [Proposal: Temporal](https://github.com/tc39/proposal-temporal)**
 
 **NOTE:** We encourage you to experiment with the polyfill, but don't use it in production!
-The API may change before the proposal reaches Stage 3, based on feedback from TC39 reviews and implementation in JS engines.
+The API may change based on feedback from implementation in JS engines.
 Please report bugs in the [issue tracker](https://github.com/tc39/proposal-temporal/issues).
 
 Please run the polyfill with Node.js 12 or later.
@@ -23,11 +23,13 @@ $ npm install --save proposal-temporal
 ```
 
 In code:
+
 ```javascript
 const { Temporal } = require('proposal-temporal');
 ```
 
 Or, import the polyfill as an ES6 module:
+
 ```javascript
 import { Temporal } from 'proposal-temporal/lib/index.mjs';
 ```