From 6a8cbd2a9fce1bc8a14a77c4a06653e1a8bac6f6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Valentin=20Breu=C3=9F?= <vbreuss@gmail.com>
Date: Sat, 2 May 2026 22:31:31 +0200
Subject: [PATCH 1/2] ci: notify Testably.Site when documentation changes

Adds a workflow that fires the extension-documentation-updated-event
repository dispatch at Testably/Testably.Site whenever Docs/pages/**
changes on main. Site responds by re-fetching this repo'\''s docs and
redeploying https://docs.testably.org. Requires a SITE_DISPATCH_TOKEN
secret with repo write on Testably/Testably.Site.
---
 .github/workflows/notify-docs-site.yml | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)
 create mode 100644 .github/workflows/notify-docs-site.yml

diff --git a/.github/workflows/notify-docs-site.yml b/.github/workflows/notify-docs-site.yml
new file mode 100644
index 00000000..945d655c
--- /dev/null
+++ b/.github/workflows/notify-docs-site.yml
@@ -0,0 +1,22 @@
+name: Notify Docs Site
+
+on:
+    push:
+        branches: [ main ]
+        paths:
+            - 'Docs/pages/**'
+            - '.github/workflows/notify-docs-site.yml'
+    workflow_dispatch:
+
+jobs:
+    dispatch:
+        name: Trigger Site rebuild
+        runs-on: ubuntu-latest
+        steps:
+            -   name: Dispatch extension-documentation-updated-event to Testably/Testably.Site
+                uses: peter-evans/repository-dispatch@v3
+                with:
+                    token: ${{ secrets.SITE_DISPATCH_TOKEN }}
+                    repository: Testably/Testably.Site
+                    event-type: extension-documentation-updated-event
+                    client-payload: '{"source": "${{ github.repository }}", "sha": "${{ github.sha }}"}'

From 43e967f5dfa896933e0798f41a9c831dcd619020 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Valentin=20Breu=C3=9F?= <vbreuss@gmail.com>
Date: Sat, 2 May 2026 22:46:17 +0200
Subject: [PATCH 2/2] ci: address review on notify-docs-site

- Guard the dispatch job with `if: github.ref == 'refs/heads/main'` so a
  manual workflow_dispatch from a topic branch cannot trigger a Site
  rebuild.
- Drop the workflow file itself from the path filter; manual dispatch
  is enough for testing changes to the workflow.
---
 .github/workflows/notify-docs-site.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/notify-docs-site.yml b/.github/workflows/notify-docs-site.yml
index 945d655c..b2b8dff6 100644
--- a/.github/workflows/notify-docs-site.yml
+++ b/.github/workflows/notify-docs-site.yml
@@ -5,11 +5,11 @@ on:
         branches: [ main ]
         paths:
             - 'Docs/pages/**'
-            - '.github/workflows/notify-docs-site.yml'
     workflow_dispatch:
 
 jobs:
     dispatch:
+        if: github.ref == 'refs/heads/main'
         name: Trigger Site rebuild
         runs-on: ubuntu-latest
         steps: