Translation of app string resources

Translations of string resources are done at TranslateWiki.Net (aka TWN).

TWN sync for Android
About once a week we sync string resources between our code and TWN. The terms import and export are used based on the TWN perspective. We first import new strings (English + qqq) from our code bases to TWN then export translated strings out of TWN to our code bases. The following section document how this is done at a low level.

Before starting the TWN sync make sure you have joined the  IRC channel.

Import from Android code to TWN
If the last command say "No changes" then continue with the export steps.

If it says something like "Process changes at https://translatewiki.net/wiki/Special:ManageMessageGroups" then go to that URL in your browser, review the to be imported strings. See also #Notes about flags.

Run job queue if there were changes to expedite the process (otherwise you have to wait a few minutes to make sure the import, which runs in the background, is complete:

Export from TWN to Android code
This will push a new commit to Gerrit in the respective app repo(s): Go to Gerrit and run the translation tests, then merge.

Import from iOS code to TWN
TO DO: update for Github

If the last command say "No changes" the continue with the export steps.

If it says something like "Process changes at https://translatewiki.net/wiki/Special:ManageMessageGroups" then go to that URL in your browser, review the to be imported strings.

Run job queue if there were changes to expedite the process (otherwise you have to wait a few minutes to make sure the import, which runs in the background, is complete:

Export from TWN to iOS code
TO DO: update for Github

This will push a new commit to Gerrit in the respective app repo(s):

...

Notes about flags
Note about the   flag: We tend to ignore translated string resource changes, unless there is a good reason for them to be done in our code and it should be reflected in TWN. (Usually translated strings come from TWN, and not the other way around.)

Note about the   flag: If the meaning of the English string has changed then mark it as fuzzy so it shows up as  in the TWN interface. Then translators know they should translate the string again.

One time TWN sync setup
Set GERRIT_USER to the proper value. This is currently written for both Android and iOS but will need to be split up in the future. Follow steps in Gerrit settings to set up a new set of ssh keys so you don't need to do ssh agent forwarding.

Fixing translations on TWN site
To get to the string in TWN fast you can:
 * 1) go to the Message group statistics for Android or iOS,
 * 2) click on the language you want,
 * 3) switch from   to   or  ,
 * 4) then enter the translated string in the.
 * 5) From there (in the "List" tab) you can click on.

Change translations
You can change the string here but that should be left to the translators. What you can do though is to add the string  in front of the current text to mark it fuzzy/outdated. You can also look at the translation history of that particular string by clicking on the little down arrow.

Example URLs
https://translatewiki.net/w/i.php?title=Special:Translate&action=translate&group=out-wikimedia-mobile-wikipedia-android-strings&language=es&filter=

History: https://translatewiki.net/w/i.php?title=Wikimedia:Wikipedia-android-strings-app_name_prod/es&action=history

Talk: https://translatewiki.net/wiki/Wikimedia_talk:Wikipedia-android-strings-app_name_prod/es

More about Message group statistics
A given language is only exported from TWN if it has reached or exceeded a certain translation completeness threshold. Currently the threshold is set to 35%.

Translatewiki on Gerrit
https://gerrit.wikimedia.org/r/#/admin/projects/translatewiki

For Android TWN sync see, esp. the   section.