+
+
+
+
diff --git a/docs/extra.css b/docs/extra.css
index e3599627..a971d398 100644
--- a/docs/extra.css
+++ b/docs/extra.css
@@ -3,6 +3,7 @@
body {
overflow-wrap: break-word;
+ overflow-x: hidden;
}
p {
diff --git a/docs/faq.md b/docs/faq.md
index 97e65feb..34a64e6e 100644
--- a/docs/faq.md
+++ b/docs/faq.md
@@ -103,6 +103,12 @@ Linux), and the other architectures are emulated automatically.
{% include "../examples/github-with-qemu.yml" %}
```
+### Building CPython ABI3 wheels (Limited API) {: #abi3}
+
+The CPython Limited API is a subset of the Python C Extension API that's declared to be forward-compatible, meaning you can compile wheels for one version of Python, and they'll be compatible with future versions. Wheels that use the Limited API are known as ABI3 wheels.
+
+To create a package that builds ABI3 wheels, you'll need to configure your build backend to compile libraries correctly create wheels with the right tags. [Check this repo](https://github.com/joerick/python-abi3-package-sample) for an example of how to do this with setuptools.
+
### Building packages with optional C extensions
`cibuildwheel` defines the environment variable `CIBUILDWHEEL` to the value `1` allowing projects for which the C extension is optional to make it mandatory when building wheels.
@@ -127,7 +133,7 @@ There are two suggested methods for keeping cibuildwheel up to date that instead
If you use GitHub Actions for builds, you can use cibuildwheel as an action:
```yaml
-uses: pypa/cibuildwheel@v2.4.0
+uses: pypa/cibuildwheel@v2.6.1
```
This is a composite step that just runs cibuildwheel using pipx. You can set command-line options as `with:` parameters, and use `env:` as normal.
@@ -153,7 +159,7 @@ The second option, and the only one that supports other CI systems, is using a `
```bash
# requirements-cibw.txt
-cibuildwheel==2.4.0
+cibuildwheel==2.6.1
```
Then your install step would have `python -m pip install -r requirements-cibw.txt` in it. Your `.github/dependabot.yml` file could look like this:
diff --git a/docs/index.md b/docs/index.md
index 6cc7ccfd..897eaa10 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -9,3 +9,14 @@ title: Home
%}
To get started, head over to the [setup guide](setup.md).
+
+How it works
+------------
+
+This diagram summarises the steps that cibuildwheel takes on each platform to build your package's wheels.
+
+{%
+ include-markdown "diagram.md"
+%}
+
+This isn't exhaustive, for a full list of the things cibuildwheel can do, check the [options](options.md) page.
diff --git a/docs/options.md b/docs/options.md
index c9d7b742..f72b388a 100644
--- a/docs/options.md
+++ b/docs/options.md
@@ -202,16 +202,17 @@ When setting the options, you can use shell-style globbing syntax, as per [fnmat
-| | macOS | Windows | Linux Intel | Linux Other |
-|--------------|------------------------------------------------------------------------|----------------------------------|-----------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| Python 3.6 | cp36-macosx_x86_64 | cp36-win_amd64