From 10447974842a4ea578df1d94297c6d46e3791e5a Mon Sep 17 00:00:00 2001 From: Shon Thomas Date: Sat, 9 May 2026 05:12:23 -0800 Subject: [PATCH] fix(docs): auto-enable GitHub Pages from configure-pages action The docs workflow had been silently failing at the actions/configure-pages@v5 step on every push to main since PR #31 introduced it (PRs #31, #32, #34 all red on this leg) because Pages was never enabled at the repo level. The site at oneiriq.github.io/rota/ was returning HTTP 404 the whole time despite the docs PRs claiming it was shipping. Manually POSTed to /repos/Oneiriq/rota/pages with build_type=workflow to unblock the current state, and run 25601961989 confirms the workflow now builds and deploys end-to-end (oneiriq.github.io/rota/ returns 200 with the mdBook content). Adding enablement: true here as the durable fix so a future fork or a repo where Pages gets disabled doesn't silently regress to the same hidden 404 state. --- .github/workflows/docs.yml | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml index cfb51a7..2cf1b6c 100644 --- a/.github/workflows/docs.yml +++ b/.github/workflows/docs.yml @@ -31,6 +31,12 @@ jobs: - name: build book run: mdbook build book - uses: actions/configure-pages@v5 + with: + # Auto-enable Pages on first run so a clean clone of this + # repo gets a working docs site without manual repo-settings + # clicks. Was the silent failure on PRs #31, #32, #34 before + # Pages was POSTed to /repos/{owner}/{repo}/pages by hand. + enablement: true - uses: actions/upload-pages-artifact@v3 with: path: book/book