docs/conf.py(fix): disable param type injection for autodoc

tony · tony · commit a51da3ead8c5 · 2025-12-06T07:39:27.000-06:00
why: sphinx-autodoc-typehints injecting :type: fields causes RST
"Unexpected indentation" errors with Napoleon-processed docstrings
what:
- Set always_document_param_types = False
- Complements existing autodoc_typehints = "signature" setting
diff --git a/docs/conf.py b/docs/conf.py
@@ -120,6 +120,9 @@
 
 # sphinx-autodoc-typehints
 autodoc_typehints = "signature"
+# When autodoc_typehints = "signature", disable parameter type injection
+# to prevent RST indentation conflicts with Napoleon-processed docstrings
+always_document_param_types = False
 
 # sphinx.ext.napoleon
 napoleon_google_docstring = True
