Colota - Android GPS Location tracker
docs(i18n): keep the language registration out of translation PRs (#926)
Max Dietrich00f0533574bc
diff --git a/apps/docs/docs/development/translations.md b/apps/docs/docs/development/translations.mdindex 97aae957..0a9c03f3 100644--- a/apps/docs/docs/development/translations.md+++ b/apps/docs/docs/development/translations.md@@ -21,11 +21,11 @@ Error messages from the tracking service and every log line stay in English, so2. Copy `en.json` to `<code>.json` in the same folder, where `<code>` is the two-letter language code, and translate the values. Keys stay as they are and in the same (alphabetical) order.3. Copy `res/values/strings.xml` to `res/values-<code>/strings.xml` and translate it.4. Optional: run `npx -w @colota/mobile jest src/i18n` after `npm ci` and `npm run build -w @colota/shared`. It checks that your file uses English keys only and keeps every placeholder; the pull request runs the same check.-5. Optional: to try the translation in the app, register the language:+5. Optional: to try the translation in the app, register the language locally:- In `apps/mobile/src/i18n/options.ts`, import your file, add the code to `SUPPORTED_LANGUAGES`, the language's own name to `LANGUAGE_NAMES` (`de: "Deutsch"`) and the file to `resources`.- In `apps/mobile/android/app/src/main/res/xml/locales_config.xml`, add `<locale android:name="<code>" />`. A test fails when this list and `SUPPORTED_LANGUAGES` disagree.- Build and install the app as in [Local Setup](./local-setup), then pick the language under **Settings → Appearance → Language**. A release build does not notice a changed `.json` file on its own: delete `apps/mobile/android/app/build/generated/assets/react` first.-6. Open a pull request. If you skipped step 5, the maintainer registers the language.+6. Open a pull request with the two files only, without the registration. The maintainer registers the language once its main screens are translated.Regional variants such as `pt-BR`, right-to-left languages such as Arabic and languages with more than two plural forms such as Polish or Russian need changes in the app first. Open an issue before you start.