Skip to content

A local-first personal finance app

Enhance translation contribution guidelines in i18n.md (#8113)

Julian Dominguez-Schatzfe9151fde051
diff --git a/packages/docs/docs/contributing/i18n.md b/packages/docs/docs/contributing/i18n.md
index 77977f697f..794660301b 100644
--- a/packages/docs/docs/contributing/i18n.md
+++ b/packages/docs/docs/contributing/i18n.md
@@ -4,11 +4,13 @@ Are you interested in bringing Actual to a broader audience by translating and l
## Translating existing strings
-Actual uses [Weblate](https://hosted.weblate.org/projects/actualbudget/actual) to manage all translations. In particular, we use Weblate's "suggestions" system to maintain high-quality translations.
+Actual uses [Weblate](https://hosted.weblate.org/projects/actualbudget/actual) to manage all translations; you'll need to create a Weblate account with two-factor authentication enabled in order to contribute. In particular, we use Weblate's "suggestions" system to maintain high-quality translations. Please join the [community Discord](https://discord.gg/DCTSmKswXp) and visit the `#project-translate` channel for translation-related discussion!
+
+We currently only include languages in the app once at least 50% of strings have been translated. We may revise this policy as needed.
:::note Pull Requests
-We do not accept GitHub Pull Requests modifying translation files—any PRs in the translations repository will be automatically closed.
+We do not accept GitHub Pull Requests modifying translation files; any PRs in the translations repository will be automatically closed.
:::
@@ -20,7 +22,11 @@ Please only fill in translations that you are confident in, and be sure to inclu
### Voting on existing suggestions
-To help vote on high-quality strings, click on "Strings with suggestions" from a language page, and use the thumbs-up or thumbs-down icons to vote. If you click thumbs-down, it's always helpful to provide a reason so that the original translator can improve.
+To help maintain a high bar for translation quality, suggested translations are not accepted until they receive at least two up-votes.
+
+You can help identify high-quality translations by voting on them! Click on "Strings with suggestions" from a language page, and use the thumbs-up or thumbs-down icons to vote. If you click thumbs-down, it's always helpful to provide a reason so that the original translator can improve.
+
+If you see a mistranslation or malicious contribution, please flag it in the `#project-translate` channel on Discord so an admin can review it.
## Marking new strings for translation