docs: fix options page (#1821)

Signed-off-by: Henry Schreiner <henryschreineriii@gmail.com>

.readthedocs.yml

@@ -11,5 +11,5 @@ build:
     - asdf install uv latest
     - asdf global uv latest
     - uv venv
-    - uv pip install .[docs]
-    - .venv/bin/python -m mkdocs build --site-dir $READTHEDOCS_OUTPUT/html
+    - uv pip install -e.[docs]
+    - . .venv/bin/activate && mkdocs build --strict --verbose --site-dir $READTHEDOCS_OUTPUT/html

mkdocs.yml

@@ -49,3 +49,5 @@ plugins:
       module_name: docs/main
       j2_variable_start_string: «
       j2_variable_end_string: »
+      on_error_fail: true
+      on_undefined: strict

noxfile.py

@@ -133,7 +133,7 @@ def docs(session: nox.Session) -> None:
     Build the docs. Will serve unless --non-interactive
     """
     session.install("-e.[docs]")
-    session.run("mkdocs", "serve" if session.interactive else "build")
+    session.run("mkdocs", "serve" if session.interactive else "build", "--strict", *session.posargs)
 
 
 @nox.session