Merge pull request #2403 from VWS-Python/simplify-docs

Simplify docs

Author: adamtheturtle

.pre-commit-config.yaml

@@ -243,7 +243,7 @@ repos:
 
     - id: linkcheck
       name: linkcheck
-      entry: uv run --extra=dev sphinx-build -M clean docs/source/ docs/build/ -W && uv run --extra=dev sphinx-build -M linkcheck docs/source/ docs/build/ -W
+      entry: make -C docs/ linkcheck SPHINXOPTS=-W
       language: python
       types_or: [rst]
       stages: [manual]
@@ -252,7 +252,7 @@ repos:
 
     - id: spelling
       name: spelling
-      entry: uv run --extra=dev sphinx-build -M clean docs/source/ docs/build/ -W && uv run --extra=dev sphinx-build -M spelling docs/source/ docs/build/ -W
+      entry: make -C docs/ spelling SPHINXOPTS=-W
       language: python
       types_or: [rst]
       stages: [manual]
@@ -261,7 +261,7 @@ repos:
 
     - id: docs
       name: Build Documentation
-      entry: uv run --extra=dev sphinx-build -M clean docs/source/ docs/build/ -W && uv run --extra=dev sphinx-build -M html docs/source/ docs/build/ -W
+      entry: make docs
       language: python
       stages: [manual]
       pass_filenames: false

docs/Makefile

@@ -10,11 +10,11 @@ BUILDDIR      = build
 
 # Put it first so that "make" without argument is like "make help".
 help:
-	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+	@uv run --extra=dev $(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
 
 .PHONY: help Makefile
 
 # Catch-all target: route all unknown targets to Sphinx using the new
 # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
 %: Makefile
-	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+	@uv run --extra=dev $(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)