add type hints to docs

Author: xflr6

docs/conf.py

@@ -36,6 +36,7 @@
     'sphinx.ext.autosummary',
     'sphinx.ext.intersphinx',
     'sphinx.ext.napoleon',
+    'sphinx_autodoc_typehints',  # https://github.com/tox-dev/sphinx-autodoc-typehints/issues/15
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -67,6 +68,12 @@
 
 # -- Extension configuration -------------------------------------------------
 
+# https://github.com/tox-dev/sphinx-autodoc-typehints
+always_use_bars_union = True
+typehints_use_signature = True
+typehints_use_signature_return = True
+
+
 # -- Options for intersphinx extension ---------------------------------------
 
 # Example configuration for intersphinx: refer to the Python standard library.