[5.2.x] Aligned docs checks between GitHub Actions and local development.

Backport of 3f21cb06e76044ad753055700395e54a1fc4f1e9 from main.

1 files changed, 10 insertions, 30 deletions

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index a21f9398bc..385493fa9b 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -22,7 +22,9 @@ permissions:
 jobs:
   docs:
     runs-on: ubuntu-24.04
-    name: docs
+    defaults:
+      run:
+        working-directory: docs
     timeout-minutes: 60
     steps:
       - name: Checkout
@@ -35,32 +37,10 @@ jobs:
           python-version: '3.14'
           cache: 'pip'
           cache-dependency-path: 'docs/requirements.txt'
-      - run: python -m pip install -r docs/requirements.txt
-      - name: Build docs
-        run: |
-          cd docs
-          sphinx-build -b spelling -n -q -W --keep-going -d _build/doctrees -D language=en_US -j auto . _build/spelling
-
-  blacken-docs:
-    runs-on: ubuntu-latest
-    name: blacken-docs
-    timeout-minutes: 60
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-        with:
-          persist-credentials: false
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: '3.14'
-      - run: python -m pip install blacken-docs
-      - name: Build docs
-        run: |
-          cd docs
-          make black
-          RESULT=`cat _build/black/output.txt`
-          if [ "$RESULT" -gt 0 ]; then
-              echo "💥 📢 Code blocks in documentation must be reformatted with blacken-docs 📢 💥"
-          fi;
-          exit $RESULT
+      - name: Install system spell checker
+        run: sudo apt update && sudo apt install -y aspell aspell-en
+      - run: python -m pip install -r requirements.txt
+      - name: Black
+        run: make black
+      - name: Spelling
+        run: SPHINXOPTS="-q -W" make spelling