Merge pull request #2728 from VWS-Python/remove-docs-makefile

Remove docs/Makefile and use sphinx-build directly

Author: adamtheturtle

.pre-commit-config.yaml

@@ -323,7 +323,8 @@ repos:
         stages: [pre-commit]
       - id: linkcheck
         name: linkcheck
-        entry: make -C docs/ linkcheck SPHINXOPTS=-W
+        entry: uv run --extra=dev sphinx-build -M linkcheck docs/source docs/build
+          -W
         language: python
         types_or: [rst]
         stages: [manual]
@@ -332,7 +333,8 @@ repos:
 
       - id: spelling
         name: spelling
-        entry: make -C docs/ spelling SPHINXOPTS=-W
+        entry: uv run --extra=dev sphinx-build -M spelling docs/source docs/build
+          -W
         language: python
         types_or: [rst]
         stages: [manual]
@@ -341,7 +343,7 @@ repos:
 
       - id: docs
         name: Build Documentation
-        entry: make docs
+        entry: uv run --extra=dev sphinx-build -M html docs/source docs/build -W
         language: python
         stages: [manual]
         pass_filenames: false

Makefile

@@ -1,8 +1,4 @@
 SHELL := /bin/bash -euxo pipefail
-
-# Treat Sphinx warnings as errors
-SPHINXOPTS := -W
-
 .PHONY: update-secrets
 update-secrets:
     # After updating secrets, commit the new secrets.tar.gpg file.
@@ -11,7 +7,7 @@ update-secrets:
 
 .PHONY: docs
 docs:
-	make -C docs clean html SPHINXOPTS=$(SPHINXOPTS)
+	uv run --extra=dev sphinx-build -M html docs/source docs/build -W
 
 .PHONY: open-docs
 open-docs: