Conversation
… means
The GitHub Pages site has not been serving the docs app. It serves 708 bytes of
Jekyll redirect:
https://opensourceagi.github.io/GRAB-URL/ 200, the docs/ stub
https://opensourceagi.github.io/GRAB-URL/docs 404
`docs/` came back in `25e0c46` after PR #47 removed it, and Pages Source is
still "Deploy from a branch", so two publishers contend for one site. GitHub's
branch-based `pages build and deployment` keeps winning — it runs and succeeds
even on commits where `pages.yml`'s own `paths` filter skips our workflow, which
is only possible when Source is a branch. Our `Deploy docs to Pages` builds
fine every time and then dies in its deploy job:
Current status: purging_cdn
##[error]Timeout reached, aborting!
Twice in a row, on `9435e0c` and `e762e04`. `actions/deploy-pages@v5` cannot
finish a CDN purge for a site something else owns.
`architecture/documentation.md` asserted the opposite on both counts — that the
folder was gone and that Source was "GitHub Actions" — and offered the green
`deploy-pages` run as proof. It is corrected here to describe what is actually
deployed, with the CDN timeout recorded so the next reader recognises it.
**Merging this is only half the fix, and the half that does nothing alone.**
Settings → Pages → Source must be set to "GitHub Actions" first; that is
dashboard-only and no commit can do it. Removing the folder while Source is
still `/docs` leaves the branch build with nothing to publish.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Lg3gMyaXRLJyWhKzayAfz5
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Checked both hosts while writing the previous commit's diagnosis, and the note
had them backwards:
https://grab.js.org/ 200, 174 kB, the Fumadocs app
https://opensourceagi.github.io/GRAB-URL/ 200, 708 bytes of Jekyll stub
grab.js.org carries current master — the comparison table's linked library
names, no Size row, and all eight framework tabs on /docs/examples are live
there. The root `vercel.json` plus an empty Root Directory is what fixed it.
So the "grab.js.org is down" section, and the table row calling it down, are
rewritten to past tense; the dashboard settings they name are kept, because
those still have to stay as they are. The tail claiming Pages is "the working
copy of the site while Vercel is broken" is now exactly inverted, and says so.
Deleting `docs/` does not touch Vercel: the root `vercel.json` builds from the
repository root with `--filter=grab-help-docs` and never reads that folder.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Lg3gMyaXRLJyWhKzayAfz5
Codecov Report✅ All modified and coverable lines are covered by tests. 📢 Thoughts on this report? Let us know! |
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
2 participants
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.
This PR is half of a two-step fix, and it is the half that does nothing on its own. Merging it while Settings → Pages → Source is still
Deploy from a branch → /docsleaves the branch build with nothing to publish.This does not affect Vercel: the root
vercel.jsonbuilds from the repository root with--filter=grab-help-docsand never readsdocs/.What's wrong today
Both hosts, checked directly:
docs/came back in25e0c46after PR #47 removed it, and Pages Source is still branch-based, so two publishers contend for one site. GitHub'spages build and deploymentkeeps winning — it runs and succeeds even on commits wherepages.yml's ownpathsfilter skips our workflow, which is only possible when Source is a branch.Our
Deploy docs to Pagesbuilds fine every time and then dies in its deploy job:Twice in a row, on
9435e0c(run #38) ande762e04(run #39).actions/deploy-pages@v5cannot finish a CDN purge for a site something else owns. The build job is green in both.docs/README.mdstates the cause in its own words: "GitHub Pages is configured to deploy from this branch's/docsfolder."Changes
d567e68— deletedocs/, correct what it meansdocs/README.md,docs/_config.yml,docs/index.html. Nothing references them; verified by grep across the repo..claude/architecture/documentation.mdasserted the opposite on both counts — that the folder was gone and that Source was "GitHub Actions" — and offered the then-greendeploy-pagesrun as proof of the latter. It now describes what is actually deployed, records thepurging_cdnsignature so the next reader recognises it, and gives the two steps in order.6a6ac96— grab.js.org is up; Pages is the broken one nowVerification
turbo run build --filter=grab-help-docs— 4/4 tasks successfulmaster: the comparison table's linked library names, noSizerow, and all eight framework tabs on/docs/examples🤖 Generated with Claude Code
https://claude.ai/code/session_01Lg3gMyaXRLJyWhKzayAfz5