Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Page Properties
label

Status

Status
colourYellow
titleNOT StartedIN PROGRESS

Impact

Status
colourRed
titleHIGH

Driver

Alessandro Domanico 

Approver

Stakeholders

Niccolò Pasquetto Henrique de Almeida Riccardo Costa

Informed

Due date

Outcome

...

  • .properties files are used by the GUI

  • .csv files are used by the SQL scripts for the initial DB setup

  • .csv are hosted as .xlsx in Transifex and their management is manual at the moment (no GitHub-Transifex integration)

Transifex Native

In June 2020 has been announced a new possible workflow: Transifex Native.

The system allows to embed in the code the translation process through the provided Transifex SDK

...

This sure it is an interesting possibility, but it implies that we maintain two different projects in Transifex (until “gui” will be up and running), also because Transifex can handle automatically only one GitHub repository per project, so unless all the translation rely on a separated repo, we would not be able to update both (“gui” and “ui”). Moreover, it is not yet clear if the actual “gui” bundles (language_xx.properties) can be used “as is” in a React project like “ui”.

Options considered

Option 1:

Separated bundles

Option 2:

Same bundles

Option 3:

Transifex Native

Description

Separated Translation files between “gui” and “ui”

Same translation files

Indipendent System for “ui”

Pros and cons

(plus) possibility to adopt different and more reliable translations formats

(plus) It’s a Standard

(minus) double maintainance until “gui” will be still included in the release packages

(minus) more resources on Transifex

(plus) Same translations files for both “gui” and “ui”

(plus) Only one set of resources on Transifex

(minus) Transifex can handle automatically only one repository (Pull Requests), so updating both components will require manual work or more advanced release scripts

(plus) possibility to adopt different and more reliable translations formats

(plus) Integrated with Develpment

(plus) Dedicated SDK

(minus) double maintainance until “gui” will be still included in the release packages

(minus) more resources on Transifex

Estimated cost (on the acutal codebase)

Status
colourRed
titleLARGE

Status
colourYellow
titleMEDIUM

Status
colourGreen
titleLOW

Action items

  •  To define the localization pattern for the “ui” component

...