Fix failing docs build

Author: dilithjay

.github/workflows/deploy_docs.yml

@@ -4,20 +4,48 @@ on:
   push:
     branches:
       - main
-      - dj/docs
+      - '**docs**'
     paths:
       - 'docs/**'
       - '.github/workflows/deploy_docs.yml'
 
 jobs:
-  pages:
+  build-docs:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install sphinx docutils
+          pip install -r docs/requirements.txt || true
+
+      - name: Build Sphinx documentation
+        run: |
+          sphinx-build -b html docs/ docs/_build/html
+
+      - name: Upload documentation artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/_build/html
+
+  deploy:
+    needs: build-docs
     runs-on: ubuntu-latest
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
     permissions:
       pages: write
       id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
     steps:
-    - id: deployment
-      uses: sphinx-notes/pages@v3
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

docs/requirements.txt

@@ -1,2 +1,3 @@
 sphinx
-pydata-sphinx-theme
+pydata-sphinx-theme
+docutils

pyproject.toml

@@ -40,6 +40,7 @@ pytest = "^8.3.2"
 [tool.poetry.group.docs.dependencies]
 sphinx = "^8.1.3"
 pydata-sphinx-theme = "^0.16.1"
+docutils = "^0.21.2"
 
 [build-system]
 requires = ["poetry-core", "wheel"]