fix(docs): auto-enable GitHub Pages from configure-pages action#35
Merged
Conversation
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.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
The docs workflow was silently failing at
actions/configure-pages@v5on every push since PR #31 introduced it. PRs #31, #32, and #34 all show red on this leg in the Actions tab. The site at https://oneiriq.github.io/rota/ was returning HTTP 404 the whole time despite the docs PRs claiming it was shipping.Root cause: Pages was never enabled at the repo level.
gh api repos/Oneiriq/rota/pagesreturned 404;has_pageswas false.Fix
Manually POSTed to
/repos/Oneiriq/rota/pageswithbuild_type=workflowto unblock the current state. Run 25601961989 confirms end-to-end: build (6s) + deploy (10s) green, https://oneiriq.github.io/rota/ now returns HTTP 200 with the mdBook content.Added
enablement: truetoactions/configure-pages@v5so a future fork (or any state where Pages is disabled at the repo level) auto-enables Pages on first run instead of silently 404-ing.