Harden docs preview workflows

Author: cncastillo

.github/workflows/CI.yml

@@ -156,9 +156,6 @@ jobs:
     if: '!cancelled()'
     name: Documentation
     runs-on: ubuntu-latest
-    concurrency:
-      group: gh-pages-deploy
-      cancel-in-progress: false
     steps:
       - uses: actions/checkout@v6
       - uses: julia-actions/setup-julia@v2

.github/workflows/docs-preview-cleanup.yml

@@ -12,9 +12,6 @@ jobs:
   cleanup:
     name: Cleanup documentation preview
     runs-on: ubuntu-latest
-    concurrency:
-      group: gh-pages-deploy
-      cancel-in-progress: false
     steps:
       - uses: actions/checkout@v6
         with:

.github/workflows/docs-preview.yml

@@ -10,14 +10,13 @@ on:
       - master
 
 permissions:
+  actions: read
   issues: write
   pull-requests: write
 
 jobs:
   comment:
-    if: >-
-      github.event.workflow_run.event == 'pull_request' &&
-      github.event.workflow_run.conclusion == 'success'
+    if: github.event.workflow_run.event == 'pull_request'
     name: Comment documentation preview URL
     runs-on: ubuntu-latest
     steps:
@@ -44,6 +43,24 @@ jobs:
               return;
             }
 
+            if (data.head.sha !== context.payload.workflow_run.head_sha) {
+              core.info('Workflow run is not for the current pull request head.');
+              return;
+            }
+
+            const jobs = await github.paginate(github.rest.actions.listJobsForWorkflowRun, {
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              run_id: context.payload.workflow_run.id,
+              per_page: 100,
+            });
+
+            const docsJob = jobs.find(job => job.name === 'Documentation');
+            if (docsJob?.conclusion !== 'success') {
+              core.info(`Documentation job conclusion: ${docsJob?.conclusion ?? 'missing'}.`);
+              return;
+            }
+
             core.setOutput('number', pr.number);
 
       - name: Comment preview URL