Repository navigation
docs: README and guide in Spanish, German, French and Russian, plus a translation guide - #157
Merged
Merged
Conversation
… translation guide The app speaks six languages but the docs only two. The new READMEs leave out version numbers, "What's new" and the roadmap so they don't go stale every release; the guides skip the build section and point to the English one. UI labels come from each language's catalog. docs/TRANSLATING.md explains how to fix a translation or add a language, and AGENTS.md now lists all six catalogs. Co-Authored-By: Claude Opus 5.5 <[email protected]>
Contributor
There was a problem hiding this comment.
✅ No new issues found.
Reviewed changes This review covers the README and guide translations, language navigation, translation contribution guide, and repository documentation updates.
- Localized documentation Adds Spanish, German, French, and Russian README and guide pages while keeping release-specific content out of the translated READMEs.
- Language navigation Adds language links to the English and Portuguese README and guide pages and includes navigation on the new translations.
- Translation instructions Documents catalog updates, wiring a new language, translation style, and cross-platform checks; updates
AGENTS.mdaccordingly.
gpt-6-luna | 𝕏
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.

Why
The interface is in six languages since 1.6.2, but the README and the guide are only in English and Portuguese. Someone who finds the project on a German or Russian forum lands on a page they may not read, and there was no written path for people who want to help translate (the German translation came from a Reddit user on their own).
What
README.<code>.mdanddocs/GUIDE.<code>.mdfor es-ES, de-DE, fr-FR and ru-RU.releases/latest), no "What's new" and no roadmap, so a release doesn't require touching four more files. They point toCHANGELOG.en-US.mdfor news.Strings.<code>.json, so the docs say exactly what the app shows (e.g. „Zurück zum PC“, « Revenir au PC », «Вернуться к ПК»). Labels from Android TV settings, which the app doesn't have, use the usual local name with the English in parentheses where unsure.docs/TRANSLATING.md(English): how to fix a line, how to add a language (the JSON, plus the six wiring steps: csproj ×2,LocalizationService, the test row, the installer, README/changelog, TESTING.md), style rules (placeholders, short text for the TV, tone, official names) and how to run the checks without Windows. Linked from "More" in the README in every language.AGENTS.md: the catalogs rule listed three languages; it now lists all six and mentions the translated docs.The guide mentions the "sentence left in English" check from #156, so this one reads best merged after it.
No changelog entry: nothing changes in the app.
Testing
#anchorsacross the 12 pages andTRANSLATING.mdchecked with a script (GitHub slug rules, Cyrillic and accented headings included): 0 broken.🤖 Generated with Claude Code