Several CI/Workflow changes and fixes

.github/workflows/mkdocs-deploy.yml

@@ -6,10 +6,10 @@ on:
   workflow_dispatch:
 
 permissions:
-  contents: write
+  contents: read
 
 jobs:
-  deploy:
+  build:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5
@@ -25,5 +25,24 @@ jobs:
       - name: Build the site with MkDocs
         run: uv run mkdocs build --strict
 
+      - name: Upload static files as artifact
+        uses: actions/upload-pages-artifact@v4
+        with:
+          path: ./site
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+
+    permissions:
+      pages: write
+      id-token: write
+
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    steps:
       - name: Deploy to GitHub Pages
-        run: uv run mkdocs gh-deploy --force
+        id: deployment
+        uses: actions/deploy-pages@v4

.github/workflows/pr-build.yml

@@ -1,17 +1,18 @@
 name: Build the site with MkDocs
 
-permissions:
-  contents: read
-
 on:
   pull_request:
     branches: [ main ]
 
+permissions:
+  contents: read
+
 jobs:
   deploy:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5
+      - name: Checkout
+        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5
         with:
           fetch-depth: 1
 

.github/workflows/update-from-submodule.yml

@@ -3,34 +3,42 @@
 on:
   pull_request_target:
     types: [opened, synchronize]
-    branches:
-      - main
+    branches: [ main ]
   workflow_dispatch:
 
 permissions:
   contents: write
 
 jobs:
-  update-files:
-    if: github.actor == 'renovate[bot]' && startsWith(github.event.pull_request.head.ref, 'renovate/submodules-')
+  update-from-submodule:
+    if: >
+      github.actor == 'renovate[bot]' && 
+      startsWith(github.event.pull_request.head.ref, 'renovate/submodules-')
+
     runs-on: ubuntu-latest
-
     steps:
-      - name: Checkout pull request branch with submodules
+      - name: Checkout PR branch with submodules
         uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5
         with:
           # Checkout the repository at the merge commit
           ref: ${{ github.event.pull_request.head.sha }}
           fetch-depth: 0
           submodules: true
 
-      - name: Validate PR source branch
+      - name: Validate PR source repository and branch
+        shell: bash
         run: |
-          if [[ ${{ github.event.pull_request.head.repo.full_name }} != '${{ github.repository }}' ]]; then
-            echo "Untrusted repository detected! Exiting.";
-            exit 1;
+          if [[ "${{ github.event.pull_request.head.repo.full_name }}" != "${{ github.repository }}" ]]; then
+            echo "Untrusted repository detected! Exiting..."
+            exit 1
           fi
 
+      - name: Configure git identity
+        shell: bash
+        run: |
+          git config --global user.name "renovate[bot]"
+          git config --global user.email "29139614+renovate[bot]@users.noreply.github.com"
+
       - name: Import GPG key
         uses: crazy-max/ghaction-import-gpg@e89d40939c28e39f97cf32126055eeae86ba74ec # v6
         with:
@@ -38,10 +46,10 @@
           passphrase: ${{ secrets.GPG_PASSPHRASE }}
           git_user_signingkey: true
           git_commit_gpgsign: true
           fingerprint: "F768450FB05B817D0B4BC26FB9B6A9B428C8676A"
           trust_level: 5
 
       - name: Set up Python
         uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6
         with:
           python-version: '3.x'
@@ -49,12 +57,13 @@
       - name: Run repo update script
         run: python update_repo.py
 
       - name: Run CHANGELOG update script
         run: bash update-changelog.bash
 
       - name: Commit and push changes
+        shell: bash
         run: |
-          git add .
+          git add -A
           git commit -m "Update files based on submodule changes"
-          git pull --rebase origin ${{ github.event.pull_request.head.ref }}
-          git push origin HEAD:${{ github.event.pull_request.head.ref }}
+          git pull --rebase origin "${{ github.event.pull_request.head.ref }}"
+          git push origin HEAD:"${{ github.event.pull_request.head.ref }}"