docs: deactivate sphinx-autodoc-typehints for now

navis-org · Apr 7, 2024 · 3e9a1e1 · 3e9a1e1
1 parent c582404
commit 3e9a1e1
Showing 1 changed file with 3 additions and 1 deletion.
diff --git a/docs/conf.py b/docs/conf.py
@@ -141,7 +141,9 @@ def remove_pbars(filepath):
     'sphinx_copybutton',
     'sphinx_design',
     'matplotlib.sphinxext.plot_directive',
-    'sphinx_autodoc_typehints',  # unfortunately this does not play nicely with mocking
+    # `sphinx-autodoc-typehints`` has been causing errors recently:
+    #   "... threw an exception (exception: :4: (SEVERE/4) Unexpected section title."
+    #'sphinx_autodoc_typehints',  # unfortunately this does not play nicely with mocking
     #'numpydoc'
 ]