Make CI docs builds as strict as local ones (#87)

Second attempt, this time with the warning that the stricter checks picked up resolved.

.github/workflows/docs-preview.yml

@@ -45,8 +45,8 @@ jobs:
       if: github.event.action != 'closed'
       with:
         docs-folder: "docs/"
-        pre-build-command: "sphinx-build -b linkcheck . _build"
-        build-command: "sphinx-build -b dirhtml . _build"
+        pre-build-command: "sphinx-build -W -b linkcheck . _build"
+        build-command: "sphinx-build -W -b dirhtml . _build"
 
     - name: Deploy preview
       uses: rossjrw/pr-preview-action@v1

.github/workflows/docs.yml

@@ -36,8 +36,8 @@ jobs:
       uses: ammaraskar/[email protected]
       with:
         docs-folder: "docs/"
-        pre-build-command: "sphinx-build -b linkcheck . _build"
-        build-command: "sphinx-build -b dirhtml . _build"
+        pre-build-command: "sphinx-build -W -b linkcheck . _build"
+        build-command: "sphinx-build -W -b dirhtml . _build"
 
     - name: Deploy main docs
       uses: JamesIves/github-pages-deploy-action@v4

docs/conf.py

@@ -37,7 +37,7 @@
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
 
 html_theme = "furo"
-html_static_path = ["_static"]
+html_static_path: list[str] = []
 pygments_style = "sphinx"
 pygments_dark_style = "monokai"