From 5441b2d43c3cb396f5cefaf6c02f2da9894b1d8f Mon Sep 17 00:00:00 2001
From: Mike Kell <mtkell@kellengineering.com>
Date: Sun, 29 Mar 2026 19:48:41 -0400
Subject: [PATCH] Add validation-only docs workflow for non-main branches

---
 .forgejo/workflows/validate-docs.yml | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)
 create mode 100644 .forgejo/workflows/validate-docs.yml

diff --git a/.forgejo/workflows/validate-docs.yml b/.forgejo/workflows/validate-docs.yml
new file mode 100644
index 0000000..70a0107
--- /dev/null
+++ b/.forgejo/workflows/validate-docs.yml
@@ -0,0 +1,28 @@
+name: Validate Docs
+
+on:
+  push:
+    branches:
+      - '**'
+      - '!main'
+
+jobs:
+  validate-docs:
+    runs-on: docker
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Build MkDocs site
+        run: |
+          docker run --rm \
+            -v "$PWD:/docs" \
+            squidfunk/mkdocs-material:9 \
+            build
+
+      - name: Validate expected output
+        run: |
+          test -f site/index.html
+          test -d site/architecture
+          echo "MkDocs validation passed"
\ No newline at end of file