{{ message }}
Repository navigation
docs: add Korean (한국어) README - #4939
Merged
Merged
Conversation
Add README.ko.md, a Korean translation structurally 1:1 with the English README, link it from the language switchers in README.md, README.zh-CN.md and README.ja.md, and add it to the markdownlint documentation allowlist. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Collaborator
- Translate needs-clarification / clarify as 명확화 (was 보완), matching the existing use of 명확화 for clarification in the SDD section. - Rephrase the CLI setup sentence so it does not imply the terminal is used only for setup. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Contributor
Author
|
Thanks for the careful review! Both suggestions make sense, and I've applied them in 067ed39:
AI disclosure: The changes and this reply were drafted with Claude Code (Claude Opus 5.5), and I reviewed the wording as a native Korean speaker. |
Contributor
There was a problem hiding this comment.
🟡 Changes recommended
The lint allowlist still excludes the modified Japanese README.
1 open finding
What changed in this PR
Adds a Korean README translation and connects it to the existing language navigation.
Changes:
- Adds a structurally aligned Korean README.
- Updates all README language switchers.
- Adds Korean README markdown linting.
| File | Description |
|---|---|
README.md |
Adds Korean navigation. |
README.zh-CN.md |
Adds Korean navigation. |
README.ja.md |
Adds Korean navigation. |
README.ko.md |
Provides the Korean translation. |
.github/workflows/lint.yml |
Adds Korean README linting. |
🧠 Review effort: Balanced
💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
This PR modifies README.ja.md (language switcher), but the file was outside the markdownlint DOC_GLOBS allowlist. It passes with 0 errors. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Collaborator
1 of 5 tasks
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
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.
Description
Adds a Korean translation of the project README as
README.ko.md, following the same pattern as the Simplified Chinese (#3740) and Japanese (#4560) translations.Changes
README.ko.md— a full Korean translation, structurally 1:1 with the current English README (all 9 sections, including Star history).README.md,README.zh-CN.md,README.ja.md— added한국어to the language switcher..github/workflows/lint.yml— addedREADME.ko.mdandREADME.ja.mdto the markdownlintDOC_GLOBSallowlist, alongsideREADME.zh-CN.md.Translation notes
/speckit-*skill names, example prompts inside code fences, badges, image paths, and link URLs are unchanged. Only prose and image alt text were translated.<a id>anchors are kept verbatim from the English README, so old deep links such as#-get-startedstill work after switchingREADME.mdtoREADME.ko.md.#스펙-주도-개발,#버그-수정,#아이디어-평가)./speckit-*skills.Side note
README.ja.mdwas also missing from the markdownlintDOC_GLOBSallowlist. The allowlist was introduced in #4584, which merged one day after the Japanese README. Since this PR modifiesREADME.ja.mdtoo, it is now included, following the Copilot review. It passes markdownlint with 0 errors.Testing
This is a documentation-only change with no impact on CLI behavior or slash commands.
uv run specify --help— N/A (docs-only change)uv sync --extra test && uv run pytest— 11885 passed, 316 skipped, 0 failed on macOS (skips are environment-gated, mostly PowerShell/pwshnot installed); themarkdownlintworkflow tests covering thelint.ymlchange passManual verification:
markdownlint-cli2with the repository's.markdownlint-cli2.jsonc: 0 errors on all four READMEs.src/hrefvalues, and legacy anchor IDs, and the same section count (9).git diff --checkis clean.AI Disclosure
AI disclosure: I used Claude Code (model: Claude Opus 5.5, reasoning effort: xhigh, interactive and human-supervised) to compare the existing Chinese and Japanese translations against the English source, draft the Korean translation from the English README, and run the verification above. As a native Korean speaker, I chose the terminology and reviewed the full translation myself. Extent: documentation only, plus the one-line CI allowlist entry. No code generation.
🤖 Generated with Claude Code