InnerWeb
Skip to main content

Translation Review Checklist Before the System Launch

A Polish label on the screen of a German or English version is the most common defect of multilingual deployments. This checklist shows the tester where to look and how to tell a missing translation from an overridden label, before the system starts serving guests and contractors.

6
languages to test
Source: card
8
permit field labels to check for overrides
Source: card
4
dictionaries with an English column
Source: card

First, tell apart the causes of a Polish text

An override of a label takes precedence over the translation in every language, so a foreign-language screen with a Polish label usually means an override, not a missing translation. Before a tester reports a translation error, they check in the system settings whether the label has been overridden.

Eight labels of the work permit fields and the name of the permit tile can be overridden per installation. An override can be saved bilingually, in Polish and in English. The system then selects the version matching the user's language, so a Polish label on an English screen shows that the second version was not entered.

Screen: what to check in the interface

The interface works in six languages: Polish, English, German, Finnish, Russian and Swedish. The tester goes through the key paths in every language that the plant will actually use, and records every text that appears in a language other than the one selected.

We pay particular attention to error messages, confirmations and short texts on buttons. Messages are built from ICU MessageFormat templates, and syntax errors are caught by an automated test in the CI pipeline, so they normally do not appear in the product. Manual checks focus on the correctness and naturalness of the text.

Scope of translation checks

Scope of translation checksBar chart: six languages, eight permit labels and four dictionaries with an English column to check.02468pcsLanguages: 6 pcs6 pcsLanguagesPermit labels: 8 pcs8 pcsPermit labelsDictionaries with EN column: 4 pcs4 pcsDictionaries with EN column
Source: Internationalization feature documentation of the system

Printout: a separate space of translations

The printing layer has its own set of translation keys, separate from the interface. A correct screen therefore does not prove a correct printout. The tester prints a permit in every language and compares it with the screen.

A work permit printout must be readable for the employee of a foreign company, so documents are generated in the employee's language. The printout is checked by a person who knows the language, ideally from the OHS department, because they will also judge the terminology.

Dictionaries: an English column is not enough

Only four dictionaries have a separate English column: types of work, hazards, preventive measures and safety signs. The remaining dictionaries display in the language in which they were entered.

The presence of a value in the English column does not mean the screen reads it, which is why the check is done on the live permit wizard. Safety signs can have English names consistent with the wording of the PN-EN ISO 7010 standard and the CLP regulation; empty titles are filled in.

How to record the test result

For each language we keep one row in a spreadsheet: screen, printout, dictionaries, training. For each defect we record the place, a screenshot and the cause: missing translation, override, or a local name entered in the wrong language.

After fixes the test is repeated only for the changed elements, but always in full scope for any language in which more than a few defects were found. The test result is archived together with the pilot documentation.

Checklist

Video

Frequently asked questions

Where does a Polish label on an English screen come from?

Usually from an override of the label, which takes precedence over the translation. We check the settings and add the English version.

Is checking the screen enough to judge the printout?

No. Printouts have a separate set of translation keys, so they must be printed and read separately.

Who should judge the translation?

A person who knows the language and OHS terminology. A translation without such a review often confuses the names of protective equipment.

Let us run a translation test together

We will go through the screen, the printout and the dictionaries in the chosen languages with your tester and show how to quickly find the source of a Polish text.

Let's talk