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

JE
18d ago
+97-14

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 (#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