How we localize the Simple apps (mobile and backend) and other projects.

Projects that need localization

Currently, there are four separate projects that are localized, along with the resources on each project:
    The Android application (LINK)
      Strings displayed in the user interface
    The server application (LINK)
      HTML for the progress tab in the app
      HTML for the help section in the app
      Strings returned in API responses that are displayed to the end user
      WhatsApp graphic
      SMS reminders
    The YouTube training video (LINK)
      Subtitle files
    The printed material that is delivered to the health centres Simple operates in
      BP Passports
      SOP training manual

Translation process

We started by using Google Sheets to manage translations for the projects. This quickly got problematic since syncing the source strings with the projects got cumbersome and started requiring a lot of manual effort to manage. In addition, this process was also error-prone.
We evaluated and decided on a platform called Transifex to manage translations across the board for all the projects. This platform has many benefits, primarily that it integrates with our project version control to automatically keep the source strings and translations in sync.


For a new language

    Add the language to the project on Transifex.
    Invite translators from the translation service for the language on the project.
    The translator begins translations.
    The turnaround time is 6-7 business days from the date of approval of the quotation.
    Invite the reviewer(s) to Transifex.
    Share the instructions on how to use Transifex (screen recording + guidelines below).
    The reviewer will go through the translations for the app and the BP passport
      When there are proposed changes, the reviewer can propose a change for translator by clicking on Add issue and leaving a note.
      If the overall quality of the translation is poor, Kate will set up a call between the reviewer and the translation service.
    We will email the translation service to let them know that the review is complete. They will address any issues that have been added by the reviewer by either
      Accepting the change by editing the translation.
      Leaving a comment to explain why the recommendation has not been accepted.
    Translation service completes all the translations for all projects on Transifex and the design files.
    Once >95% of the strings have been translated for a particular language, they will be pulled back into the app and the server.

Ongoing translations

    The translation service will work on any new strings in existing languages on an ongoing basis, and will send Kate a weekly quote every Monday. Kate will approve amount as needed.
    The turnaround time for new strings is 2-3 working days i.e. any new strings added on Monday will be ready latest by Thursday the same week.
    The translation service will also address any issues that have been raised weekly, and incorporate them in future translations.
    Once >95% of the strings have been translated for a particular language, they will be pulled back into the app and the server.
    Every month, the reviewer can look at the strings that were translated in the last month using the date filter (we can send an email to remind the reviewer to do this?). The reviewer can propose changes by adding an issue.

Special cases

    RTSL will send GP the print materials as InDesign files, and also upload all the text into Transifex for all languages
    GP will translate in Transifex
    RTSL reviewers will review in Transifex
    Once the translation has been approved in Transifex, GP will import the translation into the InDesign file/do any necessary layout adjustment
    GP will post the InDesign file with the approved translation to Transifex
Last modified 29d ago