You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Next action: port the English README's information architecture to README.ko.md, README.ja.md and README.zh-CN.md. Nothing blocks it — the English side is settled and merged.
#794 rebuilt README.md against the README redesign SSOT and left the three translations on the structure that preceded it. A reader who follows the language links from the English page lands on a different document, not a translated one.
Measured on the merge commit:
file
lines
## headings
animated logo
hero
README.md
388
13
yes
yes
README.ko.md
466
20
no
yes
README.ja.md
472
20
no
yes
README.zh-CN.md
452
20
no
yes
The tests still pass, which is the point worth stating plainly: the suites assert per-file contracts — the install pin, the guard figures, the exposure table, the refs/notes/* distinction, section order — and each translation still satisfies its own. Nothing checks that the four files describe the same product in the same order, so the divergence is invisible to CI.
What the port has to carry
The brand block: assets/readme/commitlore-logo.svg at 440px with alt in the file's language, replacing the retired commitlore-mark.svg reference if one is still there.
The 13-heading structure and its <!-- README:* --> markers.
The facts restored during the English rewrite, since the translations were never missing them and must not lose them in the port: the docs: correct measured retrieval claim #167 exposure table, the refs/notes/* trailers-versus-notes distinction, the host-policy sentence, guard precision 44.8% / recall 22.0%, and the install promise.
Two decisions the port inherits
Both were made on the English file in #794 and should be applied rather than re-litigated per language, or the four files diverge again on meaning instead of structure:
Stop re-reviewing the same bad idea. is the hero line again. It had been moved out of the hero deliberately — the comment in test/readme-order.test.ts records why: at 22% guard recall it implies a judgement the product cannot make. The SSOT puts it back. Worth knowing before it is translated three more times.
Worth adding while the files are open
A parity assertion, so the next divergence fails CI instead of waiting for a reader to find it: same heading count, same marker set, same asset references across all four.
Next action: port the English README's information architecture to
README.ko.md,README.ja.mdandREADME.zh-CN.md. Nothing blocks it — the English side is settled and merged.#794 rebuilt
README.mdagainst the README redesign SSOT and left the three translations on the structure that preceded it. A reader who follows the language links from the English page lands on a different document, not a translated one.Measured on the merge commit:
##headingsREADME.mdREADME.ko.mdREADME.ja.mdREADME.zh-CN.mdThe tests still pass, which is the point worth stating plainly: the suites assert per-file contracts — the install pin, the guard figures, the exposure table, the
refs/notes/*distinction, section order — and each translation still satisfies its own. Nothing checks that the four files describe the same product in the same order, so the divergence is invisible to CI.What the port has to carry
assets/readme/commitlore-logo.svgat 440px withaltin the file's language, replacing the retiredcommitlore-mark.svgreference if one is still there.<!-- README:* -->markers.refs/notes/*trailers-versus-notes distinction, the host-policy sentence, guard precision 44.8% / recall 22.0%, and the install promise.Two decisions the port inherits
Both were made on the English file in #794 and should be applied rather than re-litigated per language, or the four files diverge again on meaning instead of structure:
test/readme-order.test.tsasserts only that neither section precedes the automation boundary.Stop re-reviewing the same bad idea.is the hero line again. It had been moved out of the hero deliberately — the comment intest/readme-order.test.tsrecords why: at 22% guard recall it implies a judgement the product cannot make. The SSOT puts it back. Worth knowing before it is translated three more times.Worth adding while the files are open
A parity assertion, so the next divergence fails CI instead of waiting for a reader to find it: same heading count, same marker set, same asset references across all four.