diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 89a7b08..7e6119f 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -40,10 +40,15 @@ branch on `experimental`, and open your pull request against it. ## Translating -Translations happen on [Weblate](https://hosted.weblate.org/engage/gearslip/), not in pull +Translations happen on [Weblate](https://hosted.weblate.org/engage/gearslip/), never in pull requests. Pick your language, or start a new one, and translate in the browser. Weblate sends the finished work to this repository as a pull request. +Don't edit the translated `values-*/strings.xml` files by hand. Weblate keeps its own copy of +every language, so a change made in git collides with Weblate's next update, and the pull +request that made it gets closed. If a code change adds or rewords text, change only the +English file, `values/strings.xml`; Weblate picks up the new strings for translators. + Keep the tone of the English: short, plain, and friendly. Leave placeholders such as `%1$s` and `%1$d` in place; Gearslip fills them with names and numbers. Untranslated strings show in English, so a partial translation is still useful. diff --git a/README.md b/README.md index be3779a..dfff888 100644 --- a/README.md +++ b/README.md @@ -11,10 +11,11 @@ An Android Auto alternative built for everyone. [![Translation status](https://hosted.weblate.org/widget/gearslip/app/svg-badge.svg)](https://hosted.weblate.org/engage/gearslip/) -Gearslip speaks English, Arabic, Chinese, Czech, Dutch, French, German, Italian, Japanese, -Korean, Polish, Portuguese, Russian, Spanish, Swedish, Turkish, and Ukrainian. Most of these -started as machine translations, so some read awkwardly. +Gearslip speaks English, Arabic, Chinese, Czech, Danish, Dutch, French, German, Italian, +Japanese, Korean, Polish, Portuguese, Romanian, Russian, Spanish, Swedish, Turkish, and +Ukrainian. Most of these started as machine translations, so some read awkwardly. [Fix or add your language on Weblate](https://hosted.weblate.org/engage/gearslip/). +Translations go through Weblate only; pull requests that edit them get closed. Questions, ideas? [Join the discussion on Matrix](https://matrix.to/#/!mf0_mgBd5KqKpc9FfX_wHp1jFCcwAtPrndIn_oGIyMk?via=matrix.org). @@ -173,7 +174,9 @@ Bug reports from real cars help most, and pull requests are welcome. on, and the one-time agreement you sign before your first pull request merges. To help translate Gearslip into your language, join -[Gearslip on Weblate](https://hosted.weblate.org/engage/gearslip/). No coding needed. +[Gearslip on Weblate](https://hosted.weblate.org/engage/gearslip/). No coding needed. Please +don't send translations as pull requests: Weblate holds its own copy of every language, and +changes made in git collide with it. ## Building