René's URL Explorer Experiment


Title: docs: publish translated docs in twelve languages and the tool that maintains them by maxisbey · Pull Request #3280 · modelcontextprotocol/python-sdk · GitHub

Open Graph Title: docs: publish translated docs in twelve languages and the tool that maintains them by maxisbey · Pull Request #3280 · modelcontextprotocol/python-sdk

X Title: docs: publish translated docs in twelve languages and the tool that maintains them by maxisbey · Pull Request #3280 · modelcontextprotocol/python-sdk

Description: Ships the docs in twelve languages — de, es, fr, hi, ja, ko, pt (Brazilian), ru, tr, uk, zh and zh-hant, each at // — machine-translated from the English pages, plus the small tool that keeps them current. English stays the only source; everything under i18n//pages/ is generated. Supersedes #3231 and #3265 (same goal; this takes the review of both into account — notably no anchor edits to the English docs, no nav-label subsystem, no second-model gate, no state file). scripts/docs/translations.py — three commands: status, translate --lang X [--pages …], stage [--lang X]. Pages are split at ## sections; only sections whose English changed are re-translated and everything else is carried forward byte-for-byte, so a one-line English edit is a one-line translated diff. Heading ids come from the site renderer itself and are pinned into the translation; code blocks are re-imposed from the English mechanically and link targets are checked against it. Provenance (section hashes) lives in each generated page's front matter — no side state. Corrections are inputs: i18n//instructions.md (register, voice, typography) and glossary.json (terms, keep-list, banned renderings), then translate --pages … for the affected pages; the generated pages are never hand-edited. Build: language sites are staged (English overlaid with translations, a short notice after each H1 — machine-translated / behind the English page / shown in English), sidebar titles come from each translated page's own H1, and language builds are non-strict (missing snippet files included), so an English-only PR can't fail because of translations; a page whose English has changed since is served exactly as generated under an "outdated" notice until refreshed, and a page never translated is shown in English. The language sites add about a minute to the docs build in total; the API reference is linked, not rebuilt per language. The language switcher shows code - name and keeps you on the current page when you change language. docs/translations.md explains all this to readers. Intentional behavior changes None to the SDK. The docs build now also produces the twelve language sites; anthropic is added in a non-default translate dependency group (normal installs don't get it). Review notes Registers/terminology are provisional pending native review — Portuguese has a reviewer lined up; reading order: i18n/general-prompt.md → i18n/pt/instructions.md + glossary.json → a few pages under i18n/pt/pages/ → docs/translations.md → the tool. Known follow-ups: CJK search segmentation needs a Zensical bump (blocked on packaging, tracked separately); French spacing uses ordinary rather than no-break spaces (the model won't emit U+00A0; a small deterministic pass could); the "API Reference" nav label stays English on language sites; a handful of terminology consistency notes for native reviewers are listed in i18n//glossary.json notes as provisional. Running the tool needs ANTHROPIC_API_KEY; nothing in CI calls the API. What the tool checks mechanically is deliberately bounded: heading skeleton and ids, code blocks, link targets, inline code, admonition/tab markers and list/table counts, per section. Placement within a section, glossary keep-terms, block titles and anything else about the prose is left to review of the (ordinary, human-reviewed) PR that commits regenerated pages. AI Disclaimer

Open Graph Description: Ships the docs in twelve languages — de, es, fr, hi, ja, ko, pt (Brazilian), ru, tr, uk, zh and zh-hant, each at /<code>/ — machine-translated from the English pages, plus the small tool that...

X Description: Ships the docs in twelve languages — de, es, fr, hi, ja, ko, pt (Brazilian), ru, tr, uk, zh and zh-hant, each at /&lt;code&gt;/ — machine-translated from the English pages, plus the small t...

Opengraph URL: https://github.com/modelcontextprotocol/python-sdk/pull/3280

X: @github

direct link

Domain: github.com

react-profiling0
react-import-mapreact,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322
route-pattern/:user_id/:repository/pull/:id/files(.:format)
route-controllerpull_requests
route-actionfiles
fetch-noncev2:b67fcfa5-58ef-9360-54f0-8a2a2dbb0b52
current-catalog-service-hashae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b
request-id97AE:DB09F:3BD6C6:4DB8B7:6B00D427
html-safe-nonce3510f15498b70eb2918229d61bb49166de7f8294d9f47bd95a79c4bd4fde3985
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiI5N0FFOkRCMDlGOjNCRDZDNjo0REI4Qjc6NkIwMEQ0MjciLCJ2aXNpdG9yX2lkIjoiNDUwODU4NjE2MzUwNTc3OTc1MSIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9
visitor-hmac50ac7ba93279451e670508ec5f0573ad6be586fafac54a4ddc541234da0f4bd8
hovercard-subject-tagpull_request:4251748955
github-keyboard-shortcutsrepository,pull-request-list,pull-request-conversation,pull-request-files-changed,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///pull_requests/show/files
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/modelcontextprotocol/python-sdk/pull/3280/files
twitter:imagehttps://avatars.githubusercontent.com/u/224885523?s=400&v=4
twitter:cardsummary_large_image
og:imagehttps://avatars.githubusercontent.com/u/224885523?s=400&v=4
og:image:altShips the docs in twelve languages — de, es, fr, hi, ja, ko, pt (Brazilian), ru, tr, uk, zh and zh-hant, each at /<code>/ — machine-translated from the English pages, plus the small tool that...
og:site_nameGitHub
og:typeobject
hostnamegithub.com
expected-hostnamegithub.com
None85bbdfe2b6ba16e234513bc6ceff5d848ef8449820c900692a2b4e67061931e5
turbo-cache-controlno-preview
diff-viewunified
go-importgithub.com/modelcontextprotocol/python-sdk git https://github.com/modelcontextprotocol/python-sdk.git
octolytics-dimension-user_id182288589
octolytics-dimension-user_loginmodelcontextprotocol
octolytics-dimension-repository_id862584018
octolytics-dimension-repository_nwomodelcontextprotocol/python-sdk
octolytics-dimension-repository_publictrue
octolytics-dimension-repository_is_forkfalse
octolytics-dimension-repository_network_root_id862584018
octolytics-dimension-repository_network_root_nwomodelcontextprotocol/python-sdk
turbo-body-classeslogged-out env-production page-responsive full-width
disable-turbotrue
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
release4943239a6d2c591325dad6e5c313e1cafda877f6
ui-targetfull
theme-color#1e2327
color-schemelight dark

Links:

Skip to contenthttps://github.com/modelcontextprotocol/python-sdk/pull/3280/files#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fmodelcontextprotocol%2Fpython-sdk%2Fpull%2F3280%2Ffiles
GitHubRepository hosting, code review, and collaborationhttps://github.com/platform
CopilotAI coding agent for tasks, projects, and automated workhttps://github.com/features/copilot
ActionsCI/CD and automationhttps://github.com/features/actions
Code QualityQuality analysis, fixes, and enforcementhttps://github.com/features/code-quality
CodespacesCloud development environmentshttps://github.com/features/codespaces
Code SecurityVulnerability detection and remediationhttps://github.com/security/advanced-security/code-security
Secret ProtectionSecret scanning and leak preventionhttps://github.com/security/advanced-security/secret-protection
All Featureshttps://github.com/features
Documentationhttps://docs.github.com/en
Traininghttps://learn.github.com/skills
Certificationshttps://learn.github.com/credentials
Build with Copilothttps://github.com/features/ai
Customize Copilothttps://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-copilot-overview
Integrationshttps://github.com/marketplace
Trending reposhttps://github.com/trending
GitHub Sponsorshttps://github.com/open-source/sponsors
Developer articleshttps://github.com/resources/articles
ChangelogYour source for the latest features, improvements, and fixes across GitHub products, all in one place.https://github.blog/changelog/
Enterpriseshttps://github.com/enterprise
Teamhttps://github.com/team
Startupshttps://github.com/enterprise/startups
Nonprofitshttps://github.com/solutions/industry/nonprofits
Healthcarehttps://github.com/solutions/industry/healthcare
Financial serviceshttps://github.com/solutions/industry/financial-services
Manufacturinghttps://github.com/solutions/industry/manufacturing
Governmenthttps://github.com/solutions/industry/government
See all industrieshttps://github.com/solutions/industry
Why GitHubhttps://github.com/why-github
Customer Storieshttps://github.com/customer-stories
Business insightshttps://github.com/solutions/executive-insights
Trust Centerhttps://github.com/trust-center
GitHub Advanced SecurityEnterprise-grade code securityhttps://github.com/security/advanced-security
Copilot for businessEnterprise-grade AI featureshttps://github.com/features/copilot/copilot-business
Premium SupportEnterprise-grade 24/7 supporthttps://github.com/enterprise/premium-support
Documentationhttps://docs.github.com/en
Resource centerhttps://github.com/resources
Bloghttps://github.blog/
Events & webinarshttps://github.com/resources/events
Community Forumhttps://github.com/orgs/community/discussions
Customer Storieshttps://github.com/customer-stories
Integrationshttps://github.com/marketplace
Customer supporthttps://help.github.com/
Traininghttps://learn.github.com/skills
GitHub Statushttps://www.githubstatus.com/
Abouthttps://github.com/about
Partnershttps://github.com/partners
Changeloghttps://github.blog/changelog/
GitHub UniverseThe event for developers, by developers — talks, workshops, and what’s next for GitHub.https://githubuniverse.com/
Pricinghttps://github.com/pricing
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fmodelcontextprotocol%2Fpython-sdk%2Fpull%2F3280%2Ffiles
Sign uphttps://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fpull_requests%2Fshow%2Ffiles&source=header-repo&source_repo=modelcontextprotocol%2Fpython-sdk
Reloadhttps://github.com/modelcontextprotocol/python-sdk/pull/3280/files
Reloadhttps://github.com/modelcontextprotocol/python-sdk/pull/3280/files
Reloadhttps://github.com/modelcontextprotocol/python-sdk/pull/3280/files
modelcontextprotocolhttps://github.com/modelcontextprotocol
python-sdkhttps://github.com/modelcontextprotocol/python-sdk
Codehttps://github.com/modelcontextprotocol/python-sdk
Issues308 (308)https://github.com/modelcontextprotocol/python-sdk/issues
Pull requests112 (112)https://github.com/modelcontextprotocol/python-sdk/pulls
Actionshttps://github.com/modelcontextprotocol/python-sdk/actions
Projectshttps://github.com/modelcontextprotocol/python-sdk/projects
Security and quality12 (12)https://github.com/modelcontextprotocol/python-sdk/security
Insightshttps://github.com/modelcontextprotocol/python-sdk/insights
Sign up for GitHub https://github.com/signup?return_to=%2Fmodelcontextprotocol%2Fpython-sdk%2Fissues%2Fnew%2Fchoose
terms of servicehttps://docs.github.com/terms
privacy statementhttps://docs.github.com/privacy
Sign inhttps://github.com/login?return_to=%2Fmodelcontextprotocol%2Fpython-sdk%2Fissues%2Fnew%2Fchoose
maxisbeyhttps://github.com/maxisbey
mainhttps://github.com/modelcontextprotocol/python-sdk/tree/main
docs/translationshttps://github.com/modelcontextprotocol/python-sdk/tree/docs/translations
Conversation 59 https://github.com/modelcontextprotocol/python-sdk/pull/3280
Commits 7 https://github.com/modelcontextprotocol/python-sdk/pull/3280/commits
Checks 43 https://github.com/modelcontextprotocol/python-sdk/pull/3280/checks
Files changed https://github.com/modelcontextprotocol/python-sdk/pull/3280/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/3280/files
docs: publish translated docs in twelve languages and the tool that maintains them https://github.com/modelcontextprotocol/python-sdk/pull/3280/files#top
Show all changes 7 commits https://github.com/modelcontextprotocol/python-sdk/pull/3280/files
c65a026 Publish translated docs (zh-CN, ja, ko, pt-BR) and the tool that main… maxisbey Aug 11, 2026 https://github.com/modelcontextprotocol/python-sdk/pull/3280/commits/c65a026833ffa53cf9a4fdb4987b4a450139e52a
6107a94 Trim the translation tooling to what publishing needs maxisbey Aug 11, 2026 https://github.com/modelcontextprotocol/python-sdk/pull/3280/commits/6107a944a72f5f626b042795705380590cee504e
4c0a8bb Extend the translated docs to twelve languages maxisbey Aug 11, 2026 https://github.com/modelcontextprotocol/python-sdk/pull/3280/commits/4c0a8bb9adcb87e7b7bc5b8c45616f9cd7d8d29a
d37ff04 Simplify the heading attribute pattern maxisbey Aug 11, 2026 https://github.com/modelcontextprotocol/python-sdk/pull/3280/commits/d37ff0421832b61957acea0e3345dee53b5eb462
00e9565 Address review comments on the translation tooling maxisbey Aug 11, 2026 https://github.com/modelcontextprotocol/python-sdk/pull/3280/commits/00e95652b329abd0d301aa77c16e9dec2ef61019
8ed9da1 Serve stored translations as generated; make site links relative maxisbey Aug 14, 2026 https://github.com/modelcontextprotocol/python-sdk/pull/3280/commits/8ed9da1bc7d568b16b5acdfb276b45ecbbf5f1d1
cf1a61f Keep language builds from stopping on a stale snippet path maxisbey Aug 14, 2026 https://github.com/modelcontextprotocol/python-sdk/pull/3280/commits/cf1a61f5eba2021bbfecaab29bda7095386c4cae
Clear filters https://github.com/modelcontextprotocol/python-sdk/pull/3280/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/3280/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/3280/files
.github/workflows/deploy-docs.ymlhttps://github.com/modelcontextprotocol/python-sdk/pull/3280/files#diff-87e860af4b9db6c503ed680b6edb6333c6f8d7659f7d1a779a2487466bbc50f6
View file https://github.com/modelcontextprotocol/python-sdk/blob/cf1a61f5eba2021bbfecaab29bda7095386c4cae/.github/workflows/deploy-docs.yml
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/modelcontextprotocol/python-sdk/pull/3280/{{ revealButtonHref }}
https://github.com/modelcontextprotocol/python-sdk/pull/3280/files#diff-87e860af4b9db6c503ed680b6edb6333c6f8d7659f7d1a779a2487466bbc50f6
https://github.com/modelcontextprotocol/python-sdk/pull/3280/files#diff-87e860af4b9db6c503ed680b6edb6333c6f8d7659f7d1a779a2487466bbc50f6
.github/workflows/docs-preview.ymlhttps://github.com/modelcontextprotocol/python-sdk/pull/3280/files#diff-b2dfe4aeecdb9075a7cc1eb9e254ffdd4c35485caefa7aea80e4895c0f379918
View file https://github.com/modelcontextprotocol/python-sdk/blob/cf1a61f5eba2021bbfecaab29bda7095386c4cae/.github/workflows/docs-preview.yml
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/modelcontextprotocol/python-sdk/pull/3280/{{ revealButtonHref }}
https://github.com/modelcontextprotocol/python-sdk/pull/3280/files#diff-b2dfe4aeecdb9075a7cc1eb9e254ffdd4c35485caefa7aea80e4895c0f379918
https://github.com/modelcontextprotocol/python-sdk/pull/3280/files#diff-b2dfe4aeecdb9075a7cc1eb9e254ffdd4c35485caefa7aea80e4895c0f379918
.gitignorehttps://github.com/modelcontextprotocol/python-sdk/pull/3280/files#diff-bc37d034bad564583790a46f19d807abfe519c5671395fd494d8cce506c42947
View file https://github.com/modelcontextprotocol/python-sdk/blob/cf1a61f5eba2021bbfecaab29bda7095386c4cae/.gitignore
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/modelcontextprotocol/python-sdk/pull/3280/{{ revealButtonHref }}
https://github.com/modelcontextprotocol/python-sdk/pull/3280/files#diff-bc37d034bad564583790a46f19d807abfe519c5671395fd494d8cce506c42947
https://github.com/modelcontextprotocol/python-sdk/pull/3280/files#diff-bc37d034bad564583790a46f19d807abfe519c5671395fd494d8cce506c42947
CONTRIBUTING.mdhttps://github.com/modelcontextprotocol/python-sdk/pull/3280/files#diff-eca12c0a30e25b4b46522ebf89465a03ba72a03f540796c979137931d8f92055
View file https://github.com/modelcontextprotocol/python-sdk/blob/cf1a61f5eba2021bbfecaab29bda7095386c4cae/CONTRIBUTING.md
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/modelcontextprotocol/python-sdk/pull/3280/{{ revealButtonHref }}
https://github.com/modelcontextprotocol/python-sdk/pull/3280/files#diff-eca12c0a30e25b4b46522ebf89465a03ba72a03f540796c979137931d8f92055
https://github.com/modelcontextprotocol/python-sdk/pull/3280/files#diff-eca12c0a30e25b4b46522ebf89465a03ba72a03f540796c979137931d8f92055
docs/js/language-switch.jshttps://github.com/modelcontextprotocol/python-sdk/pull/3280/files#diff-2d4e816ebff15ab50eaa279c8cf8ea5addf8e00519fd0cda2a3aec77206ca36e
View file https://github.com/modelcontextprotocol/python-sdk/blob/cf1a61f5eba2021bbfecaab29bda7095386c4cae/docs/js/language-switch.js
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/modelcontextprotocol/python-sdk/pull/3280/{{ revealButtonHref }}
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/3280/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/3280/files
docs/translations.mdhttps://github.com/modelcontextprotocol/python-sdk/pull/3280/files#diff-95acc418f85c25ccb3a83b49a3dc9999bb708751bfb9e1a38bd50dc6106500ec
View file https://github.com/modelcontextprotocol/python-sdk/blob/cf1a61f5eba2021bbfecaab29bda7095386c4cae/docs/translations.md
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/modelcontextprotocol/python-sdk/pull/3280/{{ revealButtonHref }}
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/3280/files
i18n/README.mdhttps://github.com/modelcontextprotocol/python-sdk/pull/3280/files#diff-d961ec1c9cc6360af95539a6e5ea69cb5badda37abfebea849ce5aa7701a2eba
View file https://github.com/modelcontextprotocol/python-sdk/blob/cf1a61f5eba2021bbfecaab29bda7095386c4cae/i18n/README.md
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/modelcontextprotocol/python-sdk/pull/3280/{{ revealButtonHref }}
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/3280/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/3280/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/3280/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/3280/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/3280/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/3280/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/3280/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/3280/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/3280/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/3280/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/3280/files
https://github.com
Termshttps://docs.github.com/site-policy/github-terms/github-terms-of-service
Privacyhttps://docs.github.com/site-policy/privacy-policies/github-privacy-statement
Securityhttps://github.com/security
Statushttps://www.githubstatus.com/
Communityhttps://github.community/
Docshttps://docs.github.com/
Contacthttps://support.github.com?tags=dotcom-footer

Viewport: width=device-width


URLs of crawlers that visited me.