docs(ko): apply native-speaker review to the Korean glossary and instructions by Jeonghyeock · Pull Request #3738 · modelcontextprotocol/python-sdk · GitHub
Skip to content

docs(ko): apply native-speaker review to the Korean glossary and instructions - #3738

Open
Jeonghyeock wants to merge 1 commit into
modelcontextprotocol:mainfrom
Jeonghyeock:ko-native-review
Open

Jeonghyeock wants to merge 1 commit into
modelcontextprotocol:mainfrom
Jeonghyeock:ko-native-review

Conversation

@Jeonghyeock

Copy link
Copy Markdown

Fixes #3732

This changes only the two human-authored inputs, i18n/ko/glossary.json and i18n/ko/instructions.md, as proposed in the issue. No generated page is touched.

glossary.json

  • capability → 지원 기능, so plain 기능 stays reserved for "feature" (issue §1).
  • elicitation → 사용자 입력 요청, with the compound forms (폼 / URL 모드 / 푸시 입력 요청) (§4).
  • deprecated: never shortened to 지원 중단, and a revision string as the point of deprecation takes 사양부터 (2026-07-28 사양부터 지원 중단 예정) (§3).
  • New era entry: name the versions instead of a time word (§2). protocol-versions.md defines the handshake era as "up to 2025-11-25" and the modern era as 2026-07-28, so "handshake era" and "modern era" follow the same rule as 2025-era and 2026-era.
  • New entries for the terms in §5: argument, parameter, annotation, docstring, spec, server-initiated request, provider, completion, Completions, wire.
  • avoid lists only where the banned string has no other meaning in these docs (와이어, 년대, 엘리시테이션, 인수, 명세, …), since the check matches the string anywhere on a page.
  • Entries this review changed or added end with "Native review (Korean (ko) docs: native-speaker review notes for glossary.json and instructions.md #3732)". The others keep their "provisional" note.

instructions.md

  • §1: fixed endings for requirement strength (must / must not / should / should not / may); headings never end in any verb ending; no -ㅂ시다.
  • §4: the 사양부터 rule for a revision string used as a point in time; the parenthetical-original example now uses 사용자 입력 요청(elicitation) (also in §5).
  • §6: records what this review covered (45 of 52 pages; advanced/ not reviewed).

Not in this PR

Re-running translate --lang ko on the affected pages. 37 of the 52 Korean pages contain at least one string the new avoid lists ban, and more use 기능 for capability, so it would amount to re-translating nearly every page. I've left that to your next translation refresh. If you'd rather have it here, I can run it and push the regenerated pages to this branch.

Checked

  • load_glossary() from scripts/docs/translations.py parses the new file (58 keep, 38 terms).
  • markdownlint with the repository config (pyproject.toml → /tool/markdown/lint) passes on instructions.md.

AI disclosure: the renderings and rules are the ones I settled in #3732; I used Claude Code to write them up as glossary notes and instruction text.

🤖 Generated with Claude Code

…ructions

- capability → 지원 기능, keeping 기능 for "feature"
- elicitation → 사용자 입력 요청 (no transliteration)
- era: name the protocol versions instead of a time word (no 2025년대)
- deprecated: "`2026-07-28` 사양부터 지원 중단 예정", never shortened to 지원 중단
- new entries for terms rendered inconsistently across pages: argument,
  parameter, annotation, docstring, spec, server-initiated request,
  provider, completion, Completions, wire
- instructions: requirement strength (must/should/may) endings, headings
  never end in a verb ending, no -ㅂ시다

Fixes modelcontextprotocol#3732

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No issues found across 2 files

Re-trigger cubic

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Korean (ko) docs: native-speaker review notes for glossary.json and instructions.md

1 participant