From ae1daf687ded472adc2b41659fb33c6ad4f9570b Mon Sep 17 00:00:00 2001
From: Stephen Waits <steve@waits.net>
Date: Wed, 6 May 2026 08:18:16 -0600
Subject: [PATCH] ci(docs): auto-enable GitHub Pages on first run
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The Docs workflow was failing on `actions/configure-pages@v5` with
"Get Pages site failed" because Pages isn't enabled on the repo
yet. Setting `enablement: true` lets the action auto-enable it so
the deploy can proceed without a manual Settings → Pages click.
---
 .github/workflows/docs.yml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index a40bf08..64433a3 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -32,6 +32,10 @@ jobs:
           cd docs/book
           mdbook build
       - uses: actions/configure-pages@v5
+        with:
+          # Auto-enable Pages on the repo if not already configured.
+          # Without this, the action errors with "Get Pages site failed".
+          enablement: true
       - uses: actions/upload-pages-artifact@v3
         with:
           path: target/book