[v1.x] ci: deploy docs to py.sdk.modelcontextprotocol.io via Pages artifact#2635
Merged
Conversation
…tifact Backport of #2634. Build both v1.x and main into a single Pages artifact (v1 at /, v2 at /v2/), deployed via actions/deploy-pages on push to either branch. Fixes the 404 at the custom domain and stops the two branches from overwriting each other's docs on release. The legacy mkdocs gh-deploy path (docs-publish job in publish-pypi.yml and the manual workflow) is removed. Github-Issue: #2614
Merged
9 tasks
pcarleton
approved these changes
May 18, 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
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.
Backport of #2634 to
v1.x.Deploys docs to
py.sdk.modelcontextprotocol.iovia GitHub Pages artifact deployment, building bothv1.xandmaininto a single site (v1 at/, v2 at/v2/).deploy-docs.ymlandscripts/build-docs.share byte-identical to #2634 — the workflow has to exist on this branch forpush: v1.xto fire, but the script always builds fromorigin/v1.x+origin/maintips so output is the same regardless of trigger. Per-branch differences from #2634:site_urlis the root URL here, theDocumentationlink inpyproject.tomlpoints at the root, and thedocs/index.mdadmonition links forward to/v2/.See #2634 for the full motivation, design notes, and maintainer action checklist. Both PRs should be merged before flipping Pages settings so the first successful deploy has correct canonical URLs on both halves of the site.
Refs #2614.
Types of changes
AI Disclaimer