Remove docs/Makefile and use sphinx-build directly

.pre-commit-config.yaml

@@ -301,7 +301,8 @@ repos:
 
       - 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]
@@ -310,7 +311,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]
@@ -319,7 +321,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,11 +1,7 @@
 SHELL := /bin/bash -euxo pipefail
-
-# Treat Sphinx warnings as errors
-SPHINXOPTS := -W
-
 .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: