Document research on removing a workaround.

aaugustin · aaugustin · commit 1a38f5a55b82 · 2026-07-08T20:06:22.000+02:00
diff --git a/docs/conf.py b/docs/conf.py
@@ -78,7 +78,9 @@
 
 autodoc_typehints_description_target = "documented"
 
-# Workaround for https://github.com/sphinx-doc/sphinx/issues/9560
+# Workaround for https://github.com/sphinx-doc/sphinx/issues/9560 (fixed)
+# but still needed due to https://github.com/sphinx-doc/sphinx/pull/14171
+# See reference/types.rst for details.
 from sphinx.domains.python import PythonDomain  # noqa: E402
 
 
diff --git a/docs/reference/types.rst b/docs/reference/types.rst
@@ -1,6 +1,10 @@
 Types
 =====
 
+.. Switch to autotype once https://github.com/sphinx-doc/sphinx/pull/14171
+.. is merged; or after dropping support for Python < 3.12 and switching to
+.. the type statement.
+
 .. automodule:: websockets.typing
 
 .. autodata:: Data
