[Website] Fix non-relative content links#9933
Merged
Merged
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
Tightens the website MDX authoring rules by enforcing relative Markdown links inside content/docs and content/blog, and updates existing content to comply so links remain verifiable and resilient to routing changes.
Changes:
- Add a build-time failure in
rewriteMdLinksfor root-absolute/docs/...and/blog/...links when authored insidecontent/*. - Convert multiple docs/blog links from hard-coded site URLs to relative
.mdfile links so the remark pipeline can rewrite/validate them. - Update website authoring documentation to reflect the new linking guidance.
Reviewed changes
Copilot reviewed 14 out of 14 changed files in this pull request and generated 3 comments.
Show a summary per file
| File | Description |
|---|---|
| website-next/src/remark/rewriteMdLinks.mjs | Enforces relative linking for /docs and /blog routes inside content sources. |
| website-next/README.md | Updates Markdown authoring guidance and examples for relative link usage. |
| website-next/content/docs/nitro/documents/operations.md | Replaces external Hot Chocolate v13 URL with a relative doc link. |
| website-next/content/docs/nitro/apis/schema-registry.md | Replaces external Hot Chocolate v13 URL with a relative doc link. |
| website-next/content/docs/nitro/apis/fusion.md | Replaces external Hot Chocolate v13 URL with a relative doc link. |
| website-next/content/docs/nitro/apis/client-registry.md | Replaces external StrawberryShake URL with a relative doc link. |
| website-next/content/docs/hotchocolate/migrating/migrate-from-13-to-14.md | Replaces external v14 URLs with relative doc links. |
| website-next/content/docs/hotchocolate/migrating/migrate-from-12-to-13.md | Replaces external v13 URLs with relative doc links (including anchored links). |
| website-next/content/docs/hotchocolate/migrating/migrate-from-11-to-12.md | Replaces external v12 URLs with relative doc links (including anchored links). |
| website-next/content/docs/hotchocolate/migrating/migrate-from-10-to-11.md | Replaces external v11 URL with a relative doc link. |
| website-next/content/blog/2026-06-06-newsletter-may-2026.md | Converts /blog/... route links to relative sibling post links. |
| website-next/content/blog/2024-08-30-hot-chocolate-14.md | Converts external Banana Cake Pop docs link to an internal relative doc link. |
| website-next/content/blog/2022-01-13-hot-chocolate-12-5.md | Converts external v12 docs links to internal relative doc links. |
| website-next/AGENTS.md | Updates contributor guidance to point to the renamed README authoring section. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
This was referenced Jun 19, 2026
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
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.
No description provided.