Fix doc build issues (#605)

Author: ianthomas23

.github/workflows/docs.yml

@@ -8,7 +8,7 @@ defaults:
     shell: bash -l {0}
 jobs:
   build_docs:
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4
       - name: Install Conda environment with Micromamba

docs/conf.py

@@ -64,11 +64,11 @@
 linkcheck_anchors = False
 linkcheck_ignore = []  # type: ignore
 
-execution_timeout = -1
-jupyter_execute_notebooks = "off"
+nb_execution_timeout = -1
+nb_execution_mode = "off"
 if "EXECUTE_NB" in os.environ:
     print("\033[93;1mWill run Jupyter notebooks!\033[0m")
-    jupyter_execute_notebooks = "force"
+    nb_execution_mode = "force"
 
 # Settings for myst-parser
 myst_enable_extensions = [

docs/contributing.md

@@ -57,6 +57,7 @@ After a change wait for the build to finish and then refresh your browser and th
 If you make a change to the python code then you will need to restart the notebook kernel to have it take effect.
 
 
+(documentation)=
 ## Documentation
 
 Our documentation is built with [Sphinx](https://www.sphinx-doc.org) from the notebooks in the `docs` folder. It contains both Markdown files and Jupyter notebooks.