Converge the Korean README on one speech level, and fix what that exposed - #753
Merged
Conversation
…osed A diagnosis pass over README.ko.md found the register mixed three ways -- 한다체 97, 합쇼체 64, 해요체 2 -- and flipping inside a single bullet list, in the section that lists what this project cannot do. That is the section where being believed matters most. The register is now 한다체 throughout, with six deliberate exceptions that follow one rule: address the reader and it stays polite, describe the product and it does not. The hero paragraph, the CTA, the table of contents, two headings, and the line that says to read the limits before installing are all direct address. The headings are also anchor targets, so changing them would break the contents links and the parity with the other three translations. Four other patterns were treated and one deliberately was not. The connective-comma habit -- the trace of English `verb-ing, and` -- went from ten instances to zero. Three left-branching modifier stacks were unwound, including the one the analysis scored highest: three clauses had to be held in mind before reaching the noun they modified. Five em-dash appositives that were followed by a Korean particle are now parentheses or separate sentences, while the sentence-final dashes stay -- those are the author's rhythm, not a translation artifact. The `A가 아니라 B` figure was left alone: it is what walks the document's claims back, and its repetition is the point rather than a tic. A verification pass then caught three defects this introduced, and one of them was not a style problem. Rewriting the `requireSignedDirective` sentence turned an adnominal modifier into a new requirement clause and added a summary assertion the original does not make -- in a sentence about a security boundary. Restoring the original wording also settled an ambiguity the Korean had all along: its surface reading put the signature in the allowlist alongside the fingerprint, and the English says only the fingerprint goes there. The sentence was mistranslated before this branch touched it. Splitting one sentence moved the subject of "읽을 수 있다" from the reader to the hook. And removing a comma after a connective collapsed two promises into one: "제거하지 않고 남기는 것을 명시한다" reads as naming only what is kept. That comma was a syntactic boundary, not decoration -- comma removal only works where the following clause is short and the subject does not change. Limit: terminology is still doubled in places (path/경로, host/호스트, wiring/배선), and that is translation-consistency work that has to move ja and zh at the same time; one connective comma survives behind bold markers where splitting would make the span cross a sentence Blast: local Undo: easy Certainty: firm Record-Id: r-kohumanize Provenance: authored Verified: the corrected sentence was checked against README.md:260-263, which requires "Git's verified signature status from this verifier's trust store and an exact %GF fingerprint in repository-local commitlore.trustedSigner" -- two requirements, only the second in the allowlist; heading count, version pins and every measured figure are unchanged, and the numbers gate and conformance suite both pass CommitLore-Version: 2.0.0
CommitLore — record lintTrailers: clean — 3 commits in 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.
Ran
README.ko.mdthrough a Korean AI-tell analysis. The honest headline is that most of what it looks for is absent — the document was translated by hand, not by machine — so this targets five named patterns and leaves everything else alone.A blanket rewrite would have been a no-op or harmful. 42 of 546 lines changed.
What was wrong, in order of weight
The register was mixed three ways — 한다체 97, 합쇼체 64, 해요체 2 — and flipped inside a single bullet list, in the section that lists what this project cannot do:
That is the section where being believed matters most.
It is now 한다체 throughout, with six exceptions that follow one rule: address the reader and it stays polite, describe the product and it does not. The hero paragraph, the CTA, the contents, two headings and the "read this before installing" line are all direct address. The headings are also anchor targets — changing them breaks the contents links and the parity with
ja/zh.Four other patterns treated, one deliberately not:
verb-ing, and): 10 → 0A가 아니라 B: left alone. It is what walks the document's claims back; the repetition is the pointThe verification pass caught three defects I introduced
And one of them was not a style problem.
Rewriting the
requireSignedDirectivesentence changed a security claim. Unwinding the modifier stack turned an adnominal into a new requirement clause and added a summary assertion (두 가지가 필요하다) the original does not make. Restored.Restoring it settled an ambiguity the Korean had all along. Its surface reading put the signature in the allowlist alongside the fingerprint.
README.md:260-263:Two requirements; only the second is in the allowlist. The sentence was mistranslated before this branch touched it, and unwinding the stack is what surfaced it.
Splitting a sentence moved a subject.
읽을 수 있다went from the reader to the hook. Split again to restore the impersonal reading.Removing a comma collapsed two promises into one.
제거하지 않으며, 남기는 것을 명시한다→제거하지 않고 남기는 것을 명시한다reads as naming only what is kept. That comma was a syntactic boundary, not decoration — comma removal only works where the following clause is short and the subject does not change.Preserved
Code blocks, tables, links, anchors, HTML, version pins, every measured figure, issue numbers, protocol terms, headings, and the field-report quote (someone else's words). Heading count is identical to
main; the numbers gate and conformance suite both pass.Known limits
Terminology is still doubled in places (
path/경로,host/호스트, wiring/배선). That is translation-consistency work and has to movejaandzhat the same time, so it is not here.One connective comma survives behind bold markers, where splitting would make the bold span cross a sentence boundary.