Remove sphinx-autodoc-typehints, no longer needed

Now done by autodoc and napoleon themselves

Author: Karel-van-de-Plassche

docs/source/conf.py

@@ -104,7 +104,7 @@
 # ones.
 extensions = [
     "sphinx.ext.autodoc",  # To auto-generate docs from Python docstrings
-    "sphinx.ext.autosectionlabel", # Allow reference sections using its title
+    "sphinx.ext.autosectionlabel",  # Allow reference sections using its title
     "sphinx.ext.todo",  # Support for todo items
     "sphinx.ext.napoleon",  # Support for NumPy and Google style docstrings
     "sphinx.ext.intersphinx",  # Generate links to other documentation files
@@ -119,9 +119,8 @@
     # 'IPython.sphinxext.ipython_directive',  # numpy
     "sphinx.ext.mathjax",  # Render math as images
     "recommonmark",  # For markdown support, does not support 'full' CommonMark syntax (yet)!
-    "sphinx_autodoc_typehints",  # Auto-parse type hints. Napoleon BEFORE typehints
     "sphinxcontrib.mermaid",  # Draw graphs using Mermaid.js
-    "sphinx_immaterial", # Sphinx immaterial theme
+    "sphinx_immaterial",  # Sphinx immaterial theme
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -300,7 +299,7 @@
 # -- Extension configuration -------------------------------------------------
 # Configuration of sphinx.ext.autodoc
 # https://www.sphinx-doc.org/en/master/usage/extensions/autodoc.html
-autodoc_typehints = "none"  # Use sphinx_autodoc_typehints instead
+autodoc_typehints = "signature"
 
 
 # from recommonmark.transform import AutoStructify
@@ -334,7 +333,7 @@
 # See https://www.sphinx-doc.org/en/master/usage/extensions/napoleon.html
 napoleon_google_docstring = True
 napoleon_numpy_docstring = False
-# napoleon_include_init_with_doc = False  # Handled by our Sphinx template
+# napoleon_include_init_with_doc = False # Handled by our Sphinx template
 # napoleon_include_private_with_doc = False # Handled by our Sphinx template
 # napoleon_include_special_with_doc = True
 # napoleon_use_admonition_for_examples = False
@@ -396,7 +395,9 @@
     "pd.DataFrame": "~pandas.NaT",
 }  # TODO: From xarray, improve! New in 3.2
 
-napoleon_attr_annotations = True  # Allow PEP 526 attributes annotations in classes. New in 3.4
+napoleon_attr_annotations = (
+    True  # Allow PEP 526 attributes annotations in classes. New in 3.4
+)
 
 # From xarray, huh?
 # napoleon_preprocess_types = True #From xarray, not in docs
@@ -426,18 +427,6 @@
 # Configuration of sphinx.ext.mathjax
 # See https://www.sphinx-doc.org/en/master/usage/extensions/math.html#module-sphinx.ext.mathjax
 
-# Configuration of sphinx_autodoc_typehints
-# See https://pypi.org/project/sphinx-autodoc-typehints/
-set_type_checking_flag = (
-    True  # Set typing.TYPE_CHECKING to True to enable "expensive" typing imports
-)
-# typehints_fully_qualified = False # If True, class names are always fully qualified (e.g. module.for.Class). If False, just the class name displays (e.g. Class)
-always_document_param_types = (
-    True  # add stub documentation for undocumented parameters to be able to add type info.
-)
-# typehints_document_rtype = True # If False, never add an :rtype: directive. If True, add the :rtype: directive if no existing :rtype: is found.
-# simplify_optional_unions = True # If True, optional parameters of type "Union[...]" are simplified as being of type Union[..., None] in the resulting documention (e.g. Optional[Union[A, B]] -> Union[A, B, None]). # If False, the "Optional"-type is kept. Note: If False, any Union containing None will be displayed as Optional! Note: If an optional parameter has only a single type (e.g Optional[A] or Union[A, None]), it will always be displayed as Optional!
-
 
 def escape_underscores(string):
     return string.replace("_", r"\_")