chore: deploy docs preview on docs changes (#2403)

.github/workflows/docs.yml

@@ -14,7 +14,7 @@ jobs:
       - uses: actions/setup-python@v5
         with:
           python-version: 3.x
-      - run: pip install mkdocs-material mkdocs-redirects
       - run: |
           cd docs
-          mkdocs gh-deploy --force
+          make install
+          make deploy

docs/Makefile

@@ -0,0 +1,15 @@
+# Minimal makefile for Sphinx documentation
+
+.PHONY: clean
+
+install:
+	pip install mkdocs mkdocs-material mkdocs-redirects
+
+build:
+	mkdocs build
+
+deploy:
+	mkdocs gh-deploy --force
+
+clean:
+	rm -rf site

netlify.toml

@@ -0,0 +1,6 @@
+# https://docs.netlify.com/configure-builds/file-based-configuration
+
+[build]
+  base    = "docs/"
+  publish = "site/"
+  command = "make install && make build"