docs: add Brazilian Portuguese and Russian READMEs - #770
Conversation
|
This is done. Merging shortly. The part I checked hardest was the guard, because Verified both invariants on both new files rather than assuming the list entry was enough. Replacing the The language row is consistent in both directions too, which is easy to half-do: README.md links both new translations and all six files link each other. Twenty checks green. I cannot review Portuguese or Russian prose and did not pretend to; the mechanical invariants are what the guard exists for and they hold. |
Description
Brazilian Portuguese and Russian readers currently have no localized entry point. Add two abridged READMEs covering the project, supported engines, installation, quick start, security, AI data flow, and contribution requirements. Both translations share the language-switcher and drift-guard update in this PR.
Type of Change
Related Issue
Closes #594
Closes #610
Claims: Portuguese, Russian.
Changes Made
README_pt.md(251 lines) andREADME_ru.md(254 lines), following the existing abridged scope. Preserve the 16 canonical engine names and quote install-table commands verbatim.main, and register both new files inLOCALIZED.Testing
Local validation on
a767100f700c10cf44a4de0aaca02b4c00b8f31c:bun run test:unit --isolate --pass-with-no-tests -t 'parseTables|table lookup|extraction|checkReadmes|readme-check CLI': 45 passed, including all 31 drift-guard tests. The name filter also selected 14 existing tests.bun run readme:check: both new translations match the canonical engine set and install commands.bun run format,lint,typecheck,knip,chart:check,channels:showcase:check,security:check, andbuild: passed.The complete local
bun run test/ coverage run was not repeated: this Windows environment lacks the Helm/chart test prerequisites and has known unrelated SQLite file-lock limitations. Full-suite, coverage, E2E and engine checks are left to the required CI workflows. No installation command in the documentation was executed as part of translation validation.Test Environment
2f4ae61216956824410ba2f16bae3f697348afe3Checklist
bun run test:coverageandbun run coverage:check)Additional Notes
Prepared with Codex, including AI-assisted translation and test authoring. Technical claims, terminology, commands, and links were reviewed and revised against the source documents; no independent native-speaker review is claimed. Language-quality feedback is welcome. The drift guard verifies technical invariants, not linguistic quality.