diff --git a/README.md b/README.md
index 80762b2c44..54bbd42e6e 100644
--- a/README.md
+++ b/README.md
@@ -52,10 +52,8 @@ When viewing the [reference documentation](https://tc39.es/proposal-temporal/doc
 The API will change before the proposal reaches Stage 3, based on feedback that we receive during this time.
 Please give us your feedback in the [issue tracker](https://github.com/tc39/proposal-temporal/issues).
 
-## Cookbook
+## Documentation
 
-A cookbook to help you get started and learn the ins and outs of Temporal is available [here](./docs/cookbook.md)
+Reference documentation and examples can be found [here](https://tc39.es/proposal-temporal/docs/index.html).
 
-## API Documentation
-
-Reference documentation and examples are in progress and can be found [here](https://tc39.es/proposal-temporal/docs/index.html).
+A cookbook to help you get started and learn the ins and outs of Temporal is available [here](https://tc39.es/proposal-temporal/docs/index.html)
diff --git a/polyfill/README.md b/polyfill/README.md
index 060f2a4bbf..c05bd99919 100644
--- a/polyfill/README.md
+++ b/polyfill/README.md
@@ -8,18 +8,28 @@ Please give us your feedback in the [issue tracker](https://github.com/tc39/prop
 
 Please run the polyfill with Node.js 12 or later.
 
+## Documentation
+
+Reference documentation and examples can be found [here](https://tc39.es/proposal-temporal/docs/index.html).
+
+A cookbook to help you get started and learn the ins and outs of Temporal is available [here](https://tc39.es/proposal-temporal/docs/index.html)
+
 ## Import as a Module
 
 You can depend on the unstable Temporal polyfill in your personal projects:
 
 ```bash
-$ npm install --save tc39/proposal-temporal
+$ npm install --save tc39-temporal
 ```
 
 In code:
+```javascript
+const { Temporal, Intl } = require('tc39-temporal');
+```
 
+Or, import the polyfill as an ES6 module:
 ```javascript
-import { Temporal } from "proposal-temporal/polyfill/lib/index.mjs";
+import { Temporal, Intl } from 'tc39-temporal/lib/index.mjs';
 ```
 
 ## Node REPL with Temporal