Repository navigation
README: English-first facade (README.md en + README.zh-CN.md zh) - #4
Merged
Merged
Conversation
…o README.zh-CN.md verbatim; top-of-file language switchers added both ways; stale cross-links to README.en.md dropped
There was a problem hiding this comment.
Confidence Score: 2/5
Summary
Score reconciled from 3/5 because the review includes a blocking finding.
Flips the repo front page to English with a verbatim Chinese twin. The diff is byte-clean and CI-green, but README.en.md was not actually removed, leaving a stale duplicate with a wrong language link.
Important Files Changed
| File | Overview |
|---|---|
| README.md | Now English (old README.en.md verbatim) plus switcher; stale 中文 cross-link dropped |
| README.zh-CN.md | New; former Chinese README.md verbatim plus switcher to README.md |
Findings
- README.en.md is still tracked and identical to main despite the description; its 中文 link now points at the English README.md. Delete it in this PR.
- Deleting README.en.md fails CI lychee (fail: true) on docs/{README,axes,findings-effort-and-speed,leaderboard-notes,manifest-schema}.en.md:3; repoint those to ../README.md in the same commit, not a follow-up.
- Chinese twins docs/{README,axes,findings-effort-and-speed,leaderboard-notes,manifest-schema}.md:3 link 首页 to ../README.md, now the English page; repoint to ../README.zh-CN.md.
- CONTRIBUTING.md:46 says README.md is Chinese with an English pointer and to keep it that way; this PR inverts it, so update that Style bullet here.
This was referenced Oct 7, 2026
Merged
Merged
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.
What
English-first facade for the repo front page:
README.mdis now the English version. The existingREADME.en.mdcontent was promoted verbatim (it was already a faithful full mirror of the Chinese page; no re-translation, no rewrite).README.zh-CN.md.README.en.md/README.mdcross-links on each facts line were dropped (the files they pointed at no longer exist in the new layout).Zero information loss (acceptance 1)
bilingual-parity-check.py, README pair): URLs / images / fractions / versions / dates / hashes all OK; the only link diffs are the by-design per-language mappings (.en.mdresult pages,/en/site page, per-language PNGs) and the two front-page switchers.English quality (acceptance 2)
The English text is the previously published
README.en.md(human-level, in use on main since before this change), not machine translation. Banned-word / AI-slop scan: 0 hits (delve, tapestry, testament, leverage, robust, seamless, furthermore, plain-language labels, etc.).Known follow-ups, intentionally NOT in this PR (docs/ is out of scope here)
After
README.en.mdis deleted, fivedocs/*.en.mdfiles carry a header link../README.en.mdthat will 404, and one line indocs/corrections-2026-09-18.en.mdmentions the old pair. Per language-structure convention the twins under docs/ keep the.en.mdsuffix; only the front page flips. Suggested follow-up: repoint those six links (../README.md→ switcher works too) in a separate docs-wide pass.Out of scope, untouched
docs/, results/, figures, data files, git history, all numbers and their wording.