build: 🔨 add doc preview action to build

justfile

@@ -54,16 +54,23 @@ format-python:
   uv run ruff check --fix .
   uv run ruff format .
 
-# Build the documentation website using Quarto
-build-website:
+# Build the Python docstrings as a section in the website using quartodoc
+build-quartodoc:
   # To let Quarto know where python is.
   export QUARTO_PYTHON=.venv/bin/python3
   # Delete any previously built files from quartodoc.
   # -f is to not give an error if the files don't exist yet.
   rm -rf docs/reference
   uv run quartodoc build
+
+# Build the documentation website using Quarto
+build-website:  build-quartodoc
   uv run quarto render --execute
 
+# Preview the documentation website with automatic reload on changes
+preview-website: build-quartodoc
+  uv run quarto preview --execute
+
 # Check the commit messages on the current branch that are not on the main branch
 check-commits:
   #!/usr/bin/env bash