Three translations described a product the English page had stopped describing - #812
Merged
Conversation
…escribing The 2026-08-19 redesign rebuilt `README.md` and left `README.ko.md`, `README.ja.md` and `README.zh-CN.md` on the structure that preceded it. A reader following the language links landed on a different document, not a translated one: 14 headings against 20, no brand logo, and a hero image the redesign had already reformatted. The tests did not catch it, and that is the part worth stating. Every suite here asserts per-file contracts -- the install pin, the guard figures, the exposure table, the `refs/notes/*` distinction, section order -- and each translation satisfied its own. Nothing asked whether the four files describe the same product in the same order, so the divergence was invisible to CI while every assertion passed. All four now carry the same 14 headings, the same `<!-- README:* -->` markers in the same order, the animated logo at 440px, the hero on one line with a translated alt, one `docs/COMPATIBILITY.md` link, and the facts the English rewrite had restored: the #167 exposure table, the trailers-versus-notes distinction, the host-policy sentence and the guard precision and recall. Record-Id: r-readmeparity Provenance: authored Certainty: firm Blast: local Undo: easy Ruled-out: retranslating from scratch | the existing Korean, Japanese and Chinese prose is better than a fresh pass would be, and the divergence was structural rather than a translation problem Ruled-out: a parity assertion in this change | it would be written against the shape this commit just produced, so it would pass by construction rather than by checking; it belongs in its own change where it can be made to fail first Limit: parity is asserted here by four counts that happen to agree, not by a test. Nothing stops the next English edit from separating them again, which is the same hole this commit is closing and the reason the assertion is worth writing next Verified: the four files were compared on heading count, logo reference, single-line hero markup and compatibility-link count before and after, and 143 assertions across the six README suites pass. Full suite 3452 passed CommitLore-Version: 2.0.0
CommitLore — record lintTrailers: clean — 1 commit in Active constraints for the paths this PR touchesLimits (87)
Ruled out (134)
Warnings (22)
Trailer violations fail this check. Active constraints are informational — they are what the repository already decided, not a verdict on this PR. |
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.
Closes #795.
The 2026-08-19 redesign rebuilt
README.mdand left the three translations on the structure that preceded it — 14 headings against 20, no brand logo, a hero the redesign had already reformatted. A reader following the language links landed on a different document, not a translated one.The tests did not catch it, and that is the part worth stating. Every suite asserts per-file contracts — install pin, guard figures, exposure table,
refs/notes/*, section order — and each translation satisfied its own. Nothing asked whether the four files describe the same product in the same order, so the divergence was invisible to CI while every assertion passed.All four now agree:
##headings](docs/COMPATIBILITY.md)Plus the facts the English rewrite restored: the #167 exposure table, the trailers-versus-notes distinction, the host-policy sentence, and guard precision 44.8% / recall 22.0%.
Limit, in the commit: parity is shown here by four counts that happen to agree, not by a test. A parity assertion written in this change would pass by construction — it belongs in its own change where it can be made to fail first.
143 README assertions pass; full suite 3452 passed.