diff --git a/pyproject.toml b/pyproject.toml
index 641cac5..ea4441b 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -6,6 +6,10 @@
 # we remove setup.py, we should also remove bin/, because the new
 # approach is via projects.scripts, which installs without the .py suffix
 
+# When doing an editable install (-e, --editable), you must be using a
+# version of pip >= 23.0. If not, it will fail very cryptically.
+#
+
 [build-system]
 requires = ["setuptools>=61.0", "wheel"]
 build-backend = "setuptools.build_meta"