Suggest running abi3audit in docs

docs/faq.md

@@ -118,6 +118,8 @@ The CPython Limited API is a subset of the Python C Extension API that's declare
 
 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.
 
+You could also consider running [abi3audit](https://github.com/trailofbits/abi3audit) against the produced wheels in order to check for abi3 violations or inconsistencies.
+
 ### Packages with optional C extensions {: #optional-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.

docs/options.md

@@ -893,9 +893,11 @@ Platform-specific environment variables are also available:<br/>
     CIBW_REPAIR_WHEEL_COMMAND_LINUX: "auditwheel repair --lib-sdir . -w {dest_dir} {wheel}"
 
     # Multi-line example - use && to join on all platforms
+    # Use abi3audit to catch issues with Limited API wheels
     CIBW_REPAIR_WHEEL_COMMAND: >
       python scripts/repair_wheel.py -w {dest_dir} {wheel} &&
-      python scripts/check_repaired_wheel.py -w {dest_dir} {wheel}
+      python scripts/check_repaired_wheel.py -w {dest_dir} {wheel} &&
+      pipx run abi3audit --strict --report {wheel}
     ```
 
 !!! tab examples "pyproject.toml"
@@ -915,10 +917,12 @@ Platform-specific environment variables are also available:<br/>
     repair-wheel-command = "auditwheel repair --lib-sdir . -w {dest_dir} {wheel}"
 
     # Multi-line example
+    # Use abi3audit to catch issues with Limited API wheels
     [tool.cibuildwheel]
     repair-wheel-command = [
       'python scripts/repair_wheel.py -w {dest_dir} {wheel}',
       'python scripts/check_repaired_wheel.py -w {dest_dir} {wheel}',
+      'pipx run abi3audit --strict --report {wheel}',
     ]
     ```