From e7d25a968015d88723a0482fbd95f4ec5882b88a Mon Sep 17 00:00:00 2001
From: Oscar Dowson <o.dowson@gmail.com>
Date: Thu, 19 Feb 2026 11:09:47 +1300
Subject: [PATCH] [docs] add a cleanup action

---
 .github/workflows/doc_cleanup.yml | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)
 create mode 100644 .github/workflows/doc_cleanup.yml

diff --git a/.github/workflows/doc_cleanup.yml b/.github/workflows/doc_cleanup.yml
new file mode 100644
index 0000000..fd7de1e
--- /dev/null
+++ b/.github/workflows/doc_cleanup.yml
@@ -0,0 +1,24 @@
+name: Doc Preview Cleanup
+on:
+  pull_request:
+    types: [closed]
+jobs:
+  doc-preview-cleanup:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout gh-pages branch
+        uses: actions/checkout@v4
+        with:
+          ref: gh-pages
+      - name: Delete preview and history + push changes
+        run: |
+            if [ -d "previews/PR$PRNUM" ]; then
+              git config user.name "Documenter.jl"
+              git config user.email "documenter@juliadocs.github.io"
+              git rm -rf "previews/PR$PRNUM"
+              git commit -m "delete preview"
+              git branch gh-pages-new $(echo "delete history" | git commit-tree HEAD^{tree})
+              git push --force origin gh-pages-new:gh-pages
+            fi
+        env:
+            PRNUM: ${{ github.event.number }}