feat: deploy PR preview to gh pages

Author: mattwang44

.github/workflows/ci.yml

@@ -3,6 +3,10 @@ name: build
 on:
   pull_request:
 
+permissions:
+  pages: write
+  contents: write
+
 jobs:
   ci:
     runs-on: ubuntu-22.04
@@ -19,5 +23,14 @@ jobs:
       - name: Install uv
         uses: astral-sh/setup-uv@v6
 
-      - name: Validate
+      - name: Build Docs in HTML
         run: VERSION=${{ github.event.repository.default_branch }} JOBS=4 MODE=html make all
+
+      - name: Deploy PR Doc Preview
+        uses: rossjrw/pr-preview-action@v1
+        with:
+          source-dir: ../cpython/Doc/build/html
+          preview-branch: gh-pages
+          token: ${{ secrets.GITHUB_TOKEN }}
+          umbrella-dir: pr-preview
+          action: auto