From 2ed6293f2d4b8fb387c83c89423af2b8dbacf043 Mon Sep 17 00:00:00 2001
From: JRS1986 <1651269+JRS1986@users.noreply.github.com>
Date: Tue, 19 May 2026 18:48:49 +0200
Subject: [PATCH] Self-enable Pages in docs.yml to avoid the bootstrap race

Pass `enablement: true` to actions/configure-pages@v5 so the first push
to main on a fresh clone or fork auto-creates the Pages site rather
than failing with "Get Pages site failed: Not Found". This was the
race we hit between the PR #69 merge and the manual settings toggle
in this repo, and would otherwise bite anyone forking the project.

No behaviour change for already-enabled repos: configure-pages
short-circuits when the site exists.
---
 .github/workflows/docs.yml | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 1288c3d..0bbb696 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -40,6 +40,12 @@ jobs:
       - name: Setup Pages
         if: github.event_name == 'push' && github.ref == 'refs/heads/main'
         uses: actions/configure-pages@v5
+        with:
+          # Auto-create the Pages site if it doesn't exist yet. Lets the workflow
+          # bootstrap a fork or fresh clone without a manual Settings → Pages click,
+          # and prevents the chicken-and-egg failure where the first push to main
+          # races ahead of the repo-level Pages enablement.
+          enablement: true
       - name: Upload Pages artifact
         if: github.event_name == 'push' && github.ref == 'refs/heads/main'
         uses: actions/upload-pages-artifact@v3