refactor: separate docs deployment into own job in release workflow

Author: jensens

.github/workflows/release.yaml

@@ -69,9 +69,10 @@ jobs:
     runs-on: ubuntu-latest
     needs: test
     permissions:
-      actions: write
       contents: write
       packages: write
+    outputs:
+      version: ${{ steps.version.outputs.version }}
     steps:
       - uses: actions/checkout@v6
         with:
@@ -121,6 +122,17 @@ jobs:
           git commit -m "chore: bump Chart.yaml to ${{ steps.version.outputs.version }} [skip ci]"
           git push origin main
 
+  docs-deploy:
+    name: Deploy Documentation
+    runs-on: ubuntu-latest
+    needs: helm-publish
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: main  # Checkout updated main with new Chart.yaml version
+
       - name: Setup Hugo
         uses: peaceiris/actions-hugo@v3
         with:
@@ -131,14 +143,14 @@ jobs:
         run: |
           mkdir -p docs/data
           cat > docs/data/build.yaml << EOF
-          version: "${{ steps.version.outputs.version }}"
+          version: "${{ needs.helm-publish.outputs.version }}"
           date: "$(date -u +'%Y-%m-%d')"
           EOF
 
       - name: Build docs
         run: hugo --source docs --minify
 
-      - name: Deploy docs to docs branch
+      - name: Deploy to docs branch
         uses: peaceiris/actions-gh-pages@v4
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}