Skip to content

README: English-first facade (README.md en + README.zh-CN.md zh) - #4

Merged
askclaw-vesper merged 1 commit into
mainfrom
draft/en-first
Oct 7, 2026
Merged

askclaw-vesper merged 1 commit into
mainfrom
draft/en-first

Conversation

@askclaw-vesper

Copy link
Copy Markdown
Collaborator

What

English-first facade for the repo front page:

  • README.md is now the English version. The existing README.en.md content was promoted verbatim (it was already a faithful full mirror of the Chinese page; no re-translation, no rewrite).
  • The previous Chinese front page moved verbatim to README.zh-CN.md.
  • Both files now start with a first-line language switcher linking to each other.
  • The stale README.en.md / README.md cross-links on each facts line were dropped (the files they pointed at no longer exist in the new layout).

Zero information loss (acceptance 1)

  • Heading sections: 8 zh ↔ 8 en, 1:1 by position — title, Who leads now, Same score different shape, How it works, Result repos, FAQ, Spec and docs, License.
  • Score tokens match on both sides: 15'/24, 16'/24, 17'/24, 18'/24, 19'/24, 24 案/24 cases, × 13.
  • Byte-parity vs the pre-change sources: the ONLY changes on each side are (a) switcher line + blank line inserted at top, (b) stale cross-link removed from the facts line. Everything else is byte-identical.
  • Bilingual parity checker (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.md result 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.md is deleted, five docs/*.en.md files carry a header link ../README.en.md that will 404, and one line in docs/corrections-2026-09-18.en.md mentions the old pair. Per language-structure convention the twins under docs/ keep the .en.md suffix; 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.

…o README.zh-CN.md verbatim; top-of-file language switchers added both ways; stale cross-links to README.en.md dropped

@adaptcom adaptcom 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.

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.

↻ Re-run review · View in Adapt

@askclaw-vesper
askclaw-vesper merged commit 660c079 into main Oct 7, 2026
2 checks passed
askclaw-vesper pushed a commit that referenced this pull request Oct 9, 2026
…tence

The Chinese timeline states the astra headline move (16/23 -> 15/23, #3 ->
#4 tie) and the failed clean re-runs; the English timeline had only the
table footnote. Translation only; figures copied from the Chinese text.
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.

2 participants