Skip to content

docs: lead in Korean, and reorder the language switcher - #18

Merged
Tuki-Dev-Ops merged 1 commit into
mainfrom
docs/korean-first-readme
Jul 30, 2026
Merged

docs: lead in Korean, and reorder the language switcher#18
Tuki-Dev-Ops merged 1 commit into
mainfrom
docs/korean-first-readme

Conversation

@Tuki-Dev-Ops

Copy link
Copy Markdown
Owner

README.md is now the Korean file and English moves to README.en.md, so the
page GitHub shows first is Korean. The switcher is reordered to
한국어 / English / 中文 / 日本語 in all four files, each bolding its own language.

Done with git mv, so history follows the content rather than reading as one file
deleted and another added.

Cross-references

Every pointer is repointed. The "see the English README" notes in the Korean,
Chinese and Japanese files all pointed at README.md — which is now the Korean
file. Left alone they would have become silent self-links, which is worse than a
broken link because nothing reports it.

pyproject

readme moves to README.en.md rather than following README.md. It becomes the
package's long description on PyPI, and that audience is not the repository's: the
repo leads in Korean by choice, but the index should stay readable to anyone
installing the package. Verified by building the sdist and reading the resulting
PKG-INFO.

Reverse it by pointing readme back at README.md if you'd rather PyPI be Korean too.

Validation

Links, anchors, HTML balance and character sets checked across all four files;
also asserted that no file still references the old README.ko.md. Package builds.

Known consequence

The Korean README is the four-section overview, so the repository's front page is
now a summary that defers to README.en.md for benchmarks, architecture rationale,
API reference and packaging. If you want Korean to carry the full documentation
instead, that's a larger translation — say the word.

🤖 Generated with Claude Code

README.md is now the Korean file and English moves to README.en.md, so the page
GitHub shows first is Korean. The switcher is reordered to 한국어 / English /
中文 / 日本語 in all four files, each bolding its own language.

Done with git mv so the history follows the content rather than reading as one
file deleted and another added.

Every cross-reference is repointed. The "see the English README" notes in the
Korean, Chinese and Japanese files pointed at README.md, which is now the
Korean one -- they would have silently become self-links, which is worse than a
broken link because nothing reports it.

pyproject's `readme` moves to README.en.md rather than following README.md. It
is the package's long description on PyPI, and that audience is not the
repository's: the repo leads in Korean by choice, the index should stay
readable to anyone installing. Verified by building the sdist and reading the
resulting PKG-INFO.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@Tuki-Dev-Ops
Tuki-Dev-Ops merged commit 3bdce3c into main Jul 30, 2026
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.

1 participant