fix: update all schema links to use absolute URLs#89
Merged
Conversation
- Changed absolute schema links (https://adcontextprotocol.org/schemas/v1/...) to relative URLs (/schemas/v1/...) - Docusaurus automatically handles these as static assets with content hashing - Works correctly in both development and production environments - Links now point to local schemas in dev and production schemas in prod - Affects all task reference documentation, data models, and protocol docs Testing confirmed: - Docusaurus converts /schemas/v1/... to /assets/files/{filename}-{hash}.json - Links work in both npm run start (dev) and production builds - Build completes without broken link warnings 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
bokelley
force-pushed
the
bokelley/fix-schema-link
branch
from
8e4b7a5 to
38f97e5
Compare
- Changed onBrokenMarkdownLinks from 'warn' to 'throw' - This ensures broken markdown anchor links will fail the build - Prevents broken links from reaching production - Aligns with onBrokenLinks: 'throw' for consistent link validation 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
5 tasks
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
Fixes broken schema links throughout the documentation by using relative URLs that Docusaurus handles correctly.
Problem
When clicking on schema links in the documentation (e.g., "Request Schema" links), users were encountering broken links on the production site.
Solution
Updated all schema links to use relative URLs (
/schemas/v1/...) instead of absolute URLs. Docusaurus automatically:/assets/files/create-media-buy-request-{hash}.json)Benefits
✅ Works in development: Links point to local schemas when running
npm run start✅ Works in production: Links point to production schemas on deployed site
✅ Automatic cache busting: Content hashes ensure fresh schemas after updates
✅ No URL hardcoding: No need to maintain environment-specific URLs
Changes
Test Plan
npm run serve)🤖 Generated with Claude Code