Repository navigation
fix(docs): restore the website build - #6007
Merged
norman-abramovitz merged 4 commits intoOct 15, 2026
Merged
norman-abramovitz merged 4 commits into
norman-abramovitz merged 4 commits into
Conversation
The website renders only docs/, so the relative ../CONTRIBUTING.md link added to the contributing guide could not be resolved and the site build failed on develop. Link the file by its GitHub URL, as the other docs do for repo files outside docs/.
A relative link out of docs/ works on GitHub but cannot be resolved by the website build, which renders only docs/. link-resolves passed such a link because the file exists. The new link-in-docs rule flags page links that resolve outside docs/; images are left alone.
The PR website build ran only when website/ changed, but the deploy also runs on docs/ changes, so a docs-only PR that broke the site merged green and the deploy failed. Run the build on either.
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.
The documentation website stopped publishing after #6004: the contributing guide gained a relative link to
../CONTRIBUTING.md, and the site build, which renders onlydocs/, could not resolve it (onBrokenMarkdownLinks: 'throw'). The deploy on develop failed at 07:24Z, so the live site is still the 10-08 build.Two checks should have caught it before merge and did not:
website-buildjob ran only whenwebsite/changed, while the deploy also runs ondocs/changes. It now runs on either.link-resolvesrule accepted the link because the file exists, just outsidedocs/. A newlink-in-docsrule rejects relative page links that leavedocs/(images are left alone).The link itself now uses its GitHub URL, as other docs do for repo files outside
docs/.Tried: with the old link,
make build websitefails with the same error as the deploy, and the docs lint reportslink-in-docson that line; with the fix, the site builds and the lint reports 0 problems across 60 files.Changelog fragment:
changelog.d/0008-website-docs-builds.md.AI disclosure (RFC-0047): prepared with AI coding assistance; reviewed by the author.