update preview docs

Author: pjhartout

.github/workflows/docs.yml

@@ -3,15 +3,18 @@ name: Deploy Sphinx docs to GitHub Pages
 on:
   push:
     branches: [ main, master, docs/pydata ]
+  pull_request:
+    types: [opened, synchronize, reopened]
   workflow_dispatch:
 
 permissions:
   contents: read
   pages: write
   id-token: write
+  pull-requests: write
 
 concurrency:
-  group: pages
+  group: pages-${{ github.ref }}
   cancel-in-progress: true
 
 jobs:
@@ -50,3 +53,18 @@ jobs:
         id: deployment
         uses: actions/deploy-pages@v4
 
+      - name: Comment PR with preview URL
+        if: github.event_name == 'pull_request'
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const previewUrl = `${{ toJSON(steps.deployment.outputs.page_url) }}`;
+            const issue_number = context.payload.pull_request.number;
+            await github.rest.issues.createComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number,
+              body: `🔍 Documentation preview for this PR: ${previewUrl}`
+            });
+