Make docs fast by removing elegant_typehints (scverse#2199)

docs/conf.py

@@ -4,6 +4,7 @@
 from datetime import datetime
 
 import matplotlib  # noqa
+from packaging.version import parse as parse_version
 
 # Don’t use tkinter agg when importing scanpy → … → matplotlib
 matplotlib.use('agg')
@@ -29,6 +30,12 @@
 author = 'Scanpy development team'
 copyright = f'{datetime.now():%Y}, the Scanpy development team.'
 version = scanpy.__version__.replace('.dirty', '')
+
+# Bumping the version updates all docs, so don't do that
+if parse_version(version).is_devrelease:
+    parsed = parse_version(version)
+    version = f"{parsed.major}.{parsed.minor}.{parsed.micro}.dev"
+
 release = version
 
 # default settings
@@ -52,7 +59,11 @@
     'sphinx_autodoc_typehints',  # needs to be after napoleon
     # 'ipython_directive',
     # 'ipython_console_highlighting',
-    'scanpydoc',
+    # 'scanpydoc',  # scanpydoc.elegant_typehints causes full doc rebuilds
+    'scanpydoc.rtd_github_links',
+    'scanpydoc.theme',
+    'scanpydoc.definition_list_typed_field',
+    'scanpydoc.autosummary_generate_imported',
     *[p.stem for p in (HERE / 'extensions').glob('*.py')],
 ]
 
@@ -69,6 +80,8 @@
 todo_include_todos = False
 api_dir = HERE / 'api'  # function_images
 
+typehints_defaults = 'braces'
+
 scanpy_tutorials_url = 'https://scanpy-tutorials.readthedocs.io/en/latest/'
 
 intersphinx_mapping = dict(