docs(readme): promotional rewrite + 8-language i18n coverage#456
Merged
Conversation
Rewrite the main README around a single positioning — a code-intelligence graph built for AI agents, not humans. New hero (tagline + stat badges + language switcher), a three-failure-mode opening (token waste / broken refactors / hallucinated deps) distilled into a problem→answer table, and design principles tied to mechanisms (mmap, rkyv, BlindSpot). All benchmark numbers, CLI surface, and the honest release-status caveat are preserved. Add full i18n parity with PR #236's language set: zh-TW (rewritten), plus new zh-CN, ja, ko, es, pt-BR, ru, hi under docs/readme_i18n/. Each carries the 8-language switcher, correct ../ / ../../ relative link targets, localized number formats where idiomatic (pt-BR 22.645 / 2,6 s), and identical structure to the English source. Final English version selected by iterating 20 variants across 5 design routes, then ranking with 10 evaluation passes (hook / scannability / credibility / differentiation / fact-check / link-integrity / visual / completeness / newcomer-conversion / holistic). Winner: balanced-hybrid v20. The query-latency figure is unified to <175 ms (the measured 174.2 ms worst case) across hero, badge, and the vs-GitNexus table — fixing the prior <170/<150 ms mismatch.
Contributor
ecp impact cache (0 symbols) — internal, used by
|
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
1 participant
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.
Rewrites the main README around a single sharp positioning — a code-intelligence graph built for AI agents, not humans — and lands full i18n parity with the language set introduced in #236.
What changed
English
README.md— promotional rewriteBlindSpot), not adjectives.i18n — 8 languages under
docs/readme_i18n/(matching #236)zh-TWrewritten; new:zh-CN,ja,ko,es,pt-BR,ru,hi...//../../relative link targets, localized number formats where idiomatic (pt-BR22.645/2,6 s).How the final version was chosen
Iterated 20 variants across 5 design routes (pain-point table · minimalist-hardcore · narrative · visual-dense · balanced-hybrid), then ranked with 10 evaluation passes — hook, scannability, technical credibility, differentiation, fact-check, link-integrity, visual design, completeness, newcomer-conversion, and a holistic deciding vote. Winner: balanced-hybrid v20, with the Opus reviewer's honest-improvement notes applied.
Verification
./paths in i18n files.<175 ms(measured 174.2 ms worst case) across hero / badge / vs-GitNexus table — fixes the prior<170/<150mismatch../paths and i18n..//../../paths).