docs: dirhtml mode for server docs

.github/workflows/release.yaml

@@ -128,7 +128,7 @@ jobs:
           pip install poetry nox nox-poetry
       - name: Building documentation
         run: |
-          nox --session docs-build --force-color
+          nox --session docs-build --force-color -- -b dirhtml
       - name: Deploy documentation 🚀
         uses: JamesIves/[email protected]
         with:

noxfile.py

@@ -145,7 +145,7 @@ def docs_build(session: Session) -> None:
 
     """
     # run with `-b dirhtml` for nicer URLS when building for publishing to a server
-    args = session.posargs or ["-b", "html", "-W", "--keep-going", "-v"]
+    args = session.posargs or ["-b", "html"]
     session.install(".")
     session.install(
         "furo",
@@ -165,7 +165,16 @@ def docs_build(session: Session) -> None:
     if build_dir.exists():
         shutil.rmtree(build_dir)
 
-    session.run("sphinx-multiversion", "docs", "docs/_build", "--color", *args)
+    session.run(
+        "sphinx-multiversion",
+        "docs",
+        "docs/_build",
+        "--color",
+        "-W",
+        "--keep-going",
+        "-v",
+        *args,
+    )
     # TODO: use the upstream versioning method once the feature is merged in to furo
     session.run(
         "cp",