Merge pull request #3760 from agriyakhetarpal/fix-doctests

Switch to single-threaded docs build for now

.github/workflows/test_on_push.yml

@@ -263,6 +263,8 @@ jobs:
     steps:
       - name: Check out PyBaMM repository
         uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
 
       # Install and cache apt packages
       - name: Install Linux system dependencies

docs/conf.py

@@ -103,7 +103,7 @@
 exclude_patterns = ["_build", "Thumbs.db", ".DS_Store", ".ipynb_checkpoints"]
 
 # Suppress warnings generated by Sphinx and/or by Sphinx extensions
-suppress_warnings = ["git.too_shallow"]
+suppress_warnings = []
 
 # -- Options for HTML output -------------------------------------------------
 

noxfile.py

@@ -255,11 +255,11 @@ def build_docs(session):
             f"{envbindir}/../tmp/html",
         )
     # Runs in CI only, treating warnings as errors
+    # Run in single-threaded mode, see
+    # https://github.com/pydata/pydata-sphinx-theme/issues/1643
     else:
         session.run(
             "sphinx-build",
-            "-j",
-            "auto",
             "-b",
             "html",
             "-W",