Update deploy-docs.yaml to upgrade action versions and streamline installation steps

Author: franioli

.github/workflows/deploy-docs.yaml

@@ -1,58 +1,58 @@
 name: Build and deploy docs
 
 on:
-  # Runs on pushes targeting the default branch
   push:
     branches: ["master"]
-
-  # Allows you to run this workflow manually from the Actions tab
   workflow_dispatch:
 
-# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
 permissions:
   contents: read
   pages: write
   id-token: write
 
-# Allow one concurrent deployment
 concurrency:
   group: "pages"
   cancel-in-progress: true
 
 jobs:
-  # Build job
   build:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
+
       - name: Setup Pages
-        uses: actions/configure-pages@v4
+        uses: actions/configure-pages@v5
+
       - name: Install uv
         uses: astral-sh/setup-uv@v4
         with:
           version: "latest"
+
       - name: Setup Python
         run: uv python install 3.9
+
       - name: Create virtual environment
         run: uv venv
-      - name: Install MkDocs and Material for MkDocs
-        run: uv pip install --upgrade mkdocstrings[python] mkdocs-material
-      - name: Install Pillow and CairoSVG (required for social card generation)
-        run: uv pip install --upgrade pillow cairosvg
+
+      - name: Install MkDocs and plugins
+        run: |
+          uv pip install --upgrade mkdocs mkdocs-material mkdocstrings[python] pillow cairosvg
+
       - name: Build site (_site directory name is used for Jekyll compatiblity)
         run: uv run mkdocs build --config-file ./mkdocs.yml --site-dir ./_site
+
       - name: Upload artifact
-        uses: actions/upload-pages-artifact@v3
+        uses: actions/upload-pages-artifact@v1
+        with:
+          path: ./_site
 
-  # Deployment job
   deploy:
+    needs: build
+    runs-on: ubuntu-latest
     environment:
       name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-    runs-on: ubuntu-latest
-    needs: build
     steps:
       - name: Deploy to GitHub Pages
         id: deployment
-        uses: actions/deploy-pages@v1
+        uses: actions/deploy-pages@v4