diff --git a/README.md b/README.md
index cdb100598..9d78d81fb 100644
--- a/README.md
+++ b/README.md
@@ -9,22 +9,25 @@
[![Build Status](https://circleci.com/gh/pyodide/pyodide.png)](https://circleci.com/gh/pyodide/pyodide)
[![Documentation Status](https://readthedocs.org/projects/pyodide/badge/?version=stable)](https://pyodide.readthedocs.io/?badge=stable)
-Python with the scientific stack, compiled to WebAssembly.
+Pyodide is a Python distribution for the browser and Node.js based on WebAssembly.
## What is Pyodide?
-Pyodide may be used in any context where you want to run Python inside a web
-browser.
+Pyodide is a port of CPython to WebAssembly/[Emscripten](https://emscripten.org/).
-Pyodide brings the Python 3.9 runtime to the browser via WebAssembly thanks to
-[Emscripten](https://emscripten.org/).
-It builds the Python scientific stack including NumPy, Pandas, Matplotlib, SciPy, and
-scikit-learn. The [packages directory](packages) lists over 75 packages which
-are currently available. In addition, it's possible to install pure Python wheels
-from PyPI.
+Pyodide makes it possible to install and run Python packages in the browser with
+[micropip](https://pyodide.org/en/stable/usage/api/micropip-api.html). Any pure
+Python package with a wheel available on PyPi is supported. Many packages with C
+extensions have also been ported for use with Pyodide. These include many
+general-purpose packages such as regex, pyyaml, lxml and scientific Python
+packages including numpy, pandas, scipy, matplotlib, and scikit-learn.
-Pyodide provides transparent conversion of objects between JavaScript and
-Python. When used inside a browser, Python has full access to the Web APIs.
+Pyodide comes with a robust Javascript ⟺ Python foreign function interface so
+that you can freely mix these two languages in your code with minimal
+friction. This includes full support for error handling (throw an error in one
+language, catch it in the other), async/await, and much more.
+
+When used inside a browser, Python has full access to the Web APIs.
## Try Pyodide (no installation needed)
diff --git a/docs/index.rst b/docs/index.rst
index b541348e7..13beea62d 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -1,21 +1,27 @@
Pyodide
=======
-Python with the scientific stack, compiled to WebAssembly.
-Pyodide may be used in any context where you want to run Python inside a web
-browser.
+Pyodide is a Python distribution for the browser and Node.js based on WebAssembly.
-Pyodide brings the Python 3.9 runtime to the browser via WebAssembly, thanks to
-`Emscripten `_.
-It builds the Python scientific stack including NumPy, Pandas, Matplotlib, SciPy, and
-scikit-learn. Over 75 packages are currently available. In addition, it's
-possible to install pure Python wheels from PyPI.
+What is Pyodide?
+----------------
-Pyodide provides transparent conversion of objects between JavaScript and
-Python. When used inside a browser, Python has full access to the Web APIs.
+Pyodide is a port of CPython to WebAssembly/[Emscripten](https://emscripten.org/).
-Pyodide development happens on GitHub: `github.com/pyodide/pyodide `_
+Pyodide makes it possible to install and run Python packages in the browser with
+[micropip](https://pyodide.org/en/stable/usage/api/micropip-api.html). Any pure
+Python package with a wheel available on PyPi is supported. Many packages with C
+extensions have also been ported for use with Pyodide. These include many
+general-purpose packages such as regex, pyyaml, lxml and scientific Python
+packages including numpy, pandas, scipy, matplotlib, and scikit-learn.
+
+Pyodide comes with a robust Javascript ⟺ Python foreign function interface so
+that you can freely mix these two languages in your code with minimal
+friction. This includes full support for error handling (throw an error in one
+language, catch it in the other), async/await, and much more.
+
+When used inside a browser, Python has full access to the Web APIs.
Try Pyodide (no installation needed)
------------------------------------
diff --git a/docs/project/about.md b/docs/project/about.md
index 0522e2bc3..434a641b7 100644
--- a/docs/project/about.md
+++ b/docs/project/about.md
@@ -1,20 +1,22 @@
-# About Pyodide
+Pyodide is a Python distribution for the browser and Node.js based on WebAssembly.
-Python with the scientific stack, compiled to WebAssembly.
+## What is Pyodide?
-Pyodide may be used in any context where you want to run Python inside a web
-browser.
+Pyodide is a port of CPython to WebAssembly/[Emscripten](https://emscripten.org/).
-Pyodide brings the Python 3.9 runtime to the browser via WebAssembly thanks to
-[Emscripten](https://emscripten.org/).
-It builds the Python scientific stack including NumPy, Pandas, Matplotlib, SciPy, and
-scikit-learn. The [packages
-directory](https://github.com/pyodide/pyodide/tree/main/packages) lists over
-75 packages which are currently available. In addition, it's possible to install
-pure Python wheels from PyPI.
+Pyodide makes it possible to install and run Python packages in the browser with
+[micropip](https://pyodide.org/en/stable/usage/api/micropip-api.html). Any pure
+Python package with a wheel available on PyPi is supported. Many packages with C
+extensions have also been ported for use with Pyodide. These include many
+general-purpose packages such as regex, pyyaml, lxml and scientific Python
+packages including numpy, pandas, scipy, matplotlib, and scikit-learn.
-Pyodide provides transparent conversion of objects between JavaScript and
-Python. When used inside a browser, Python has full access to the Web APIs.
+Pyodide comes with a robust Javascript 🡘 Python foreign function interface so
+that you can freely mix these two languages in your code with minimal
+friction. This includes full support for error handling (throw an error in one
+language, catch it in the other), async/await, and much more.
+
+When used inside a browser, Python has full access to the Web APIs.
## History