Enable parallel builds by updating theme and using --jobs auto

Author: amotl

CHANGES.rst

@@ -8,6 +8,7 @@ Unreleased
 
 - Dependencies: Unblock newer versions of Sphinx
 - Dependencies: Updated to ``sphinx-autobuild==2025.8.25``
+- Enabled parallel builds by updating theme and using ``--jobs auto``
 
 
 2.1.2 - 2024/02/28

common-build/rules.mk

@@ -50,7 +50,7 @@ PYTHON          = python3
 PIP             = $(PYTHON) -m pip
 SPHINXBUILD     = $(ENV_DIR)/bin/sphinx-build
 SPHINXAUTOBUILD = $(ENV_DIR)/bin/sphinx-autobuild
-AUTOBUILD_OPTS  = --watch $(TOP_DIR)/src --re-ignore '^(?!.+\.(?:rst|md|mmd|html|css|js|py|conf)$$)' --open-browser --delay 0
+AUTOBUILD_OPTS  = --watch $(TOP_DIR) --re-ignore '^(?!.+\.(?:rst|md|mmd|html|css|js|py|conf)$$)' --open-browser --delay 0 --jobs auto
 BUILD_DIR       = $(LOCAL_DIR)/.build
 SPHINX_ARGS     = . $(BUILD_DIR)
 SPHINX_OPTS     = -W -n

docs/requirements.txt

@@ -1,2 +1,2 @@
 sphinx>=3,<9
-crate-docs-theme
+crate-docs-theme>=0.42.0