docs: add redirects for restructured spec pages#3065
Open
claude[bot] wants to merge 1 commit into
Open
Conversation
The draft spec deletes basic/lifecycle and basic/utilities/ping, moves cancellation and progress under basic/patterns/, and moves tasks out of the core protocol into an extension. Add redirects for the old paths in two forms: draft-scoped sources that work now, and 2026-07-28-scoped sources that take effect once the /specification/latest wildcard points at 2026-07-28. Removed pages point at their closest replacement: lifecycle goes to versioning, ping goes to the changelog entry recording its removal, and tasks goes to the tasks extension overview. The draft nav already lists every restructured page, so no nav changes were needed. Co-Authored-By: Claude <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016WBaED7Rta4YsYVz66Qoru
Contributor
|
/lgtm Easy enough - this fixes 404s. |
a-akimov
approved these changes
Jul 11, 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
3 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.
Requested by Den Delimarsky · Slack thread
Following an old link such as
/specification/draft/basic/utilities/progressused to land on a 404 page after the draft spec restructure. Those URLs now redirect to the pages that carry the content, for example the cancellation and progress pages underbasic/patternsand the tasks extension overview. The same redirects exist for the2026-07-28dated paths, solatestURLs will keep resolving once the release flip repoints them.Motivation and Context
Preparation for the 2026-07-28 release. The draft spec restructure moved the cancellation and progress utilities under
basic/patternsand folded lifecycle into versioning. It also removed the ping utility (SEP-2575) and moved tasks into theio.modelcontextprotocol/tasksextension (SEP-2663).docs.jsonhad no redirects for the old URLs, so bookmarks and inbound links broke. The draft nav blocks already register all 32 draft pages, so only redirects were needed. The future redirects are keyed on dated/specification/2026-07-28/...sources rather thanlatestsources, so they stay inert until the release flip repoints thelatestwildcard, matching the existing dated-source precedent in the file.Closes #3052
How Has This Been Tested?
Documentation-only change. Ran
npm installandnpm run check:docs, which passed. That includes the prettier check on md/mdx files andmint broken-links, which reported no broken links.Breaking Changes
None.
Types of changes
Checklist
Additional context
Other rc-high-priority bundle PRs also touch
docs/docs.json, so merge order may need care.AI assistance disclosure: this change and the PR description were written with AI assistance, which also ran the lint checks above. The diff will receive human review before merge.