diff --git a/guide/src/building_and_distribution.md b/guide/src/building_and_distribution.md
index 6b013b54bf1..f7045ebbb5b 100644
--- a/guide/src/building_and_distribution.md
+++ b/guide/src/building_and_distribution.md
@@ -66,7 +66,16 @@ If you set more that one of these api version feature flags the highest version
 PyO3 is only able to link your extension module to api3 version up to and including your host Python version. E.g., if you set `abi3-py38` and try to compile the crate with a host of Python 3.6, the build will fail.
 
 As an advanced feature, you can build PyO3 wheel without calling Python interpreter with
-the environment variable `PYO3_NO_PYTHON` set, but this only works on *NIX.
+the environment variable `PYO3_NO_PYTHON` set, but this only works on \*NIX.
+
+### Missing features
+
+Due to limitations in the Python API, there are a few `pyo3` features that do
+not work when compiling for `abi3`. These are:
+
+- `#[text_signature]` does not work on classes until Python 3.10 or greater.
+- The `dict` and `weakref` options on classes are not supported.
+- The buffer API is not supported.
 
 ## Cross Compiling
 
diff --git a/guide/src/function.md b/guide/src/function.md
index a8b5978561e..9661d2bf8a9 100644
--- a/guide/src/function.md
+++ b/guide/src/function.md
@@ -129,6 +129,9 @@ impl MyClass {
 }
 ```
 
+Note that `text_signature` on classes is not compatible with compilation in
+`abi3` mode until Python 3.10 or greater.
+
 ### Making the function signature available to Python (old method)
 
 Alternatively, simply make sure the first line of your docstring is