Documentation

Globalization

Make every project ready for every market. Its code works in any language and culture, its strings are translated, and every change is checked.

Reaching another market takes more than translated strings. A product that is ready for the world keeps its text in catalogues, formats numbers, dates and money for each reader, sorts the way the reader's language sorts, and never assembles a sentence from fragments. It mirrors for right-to-left languages and leaves room for text that grows in translation. Coroid follows Microsoft's international design checklist for all of this.

Globalization in the main menu has two parts:

PartWhat it is for
InternationalizationCode ready for any language and culture: the wizard, World readiness and Culture
LocalizationEvery language, string by string: the workbench

Globalization opens on Localization. Each project's workbench groups its sections the same way: World readiness and Culture under Internationalization, and the translation sections under Localization.

From one language to many

  1. Internationalize. The Internationalization wizard sets up catalogues, languages, style and each market's money in one pull request.
  2. Clean up the code you have. World readiness lists what the code on your default branch still assumes about one language or one culture, and files small tasks to fix it.
  3. Follow each market. Culture shows what each market expects of dates, numbers, money, addresses, phone numbers and names, and which formatter the code uses for them.
  4. Translate. The Localization workbench shows where every language stands and translates what is missing.
  5. Keep it that way. The Globalization check reads every change: its strings, the code it adds, and, when you set it up, its pages rendered with a pseudo translation.

Design for every market explains what each market expects of the code, with the check's codes for each habit that gets it wrong.

Internationalization

The Internationalization part lists the projects you can read. A line at the top says how many are internationalized and how much the checks found in their existing code.

Each internationalized project's row shows what Coroid found on its default branch: text written into the code, assembled sentences, and everything else. It also shows the change since the last check. Coroid reads the code without running it. Opening a row opens the project's World readiness.

A project without translations says Not internationalized yet. Owners and admins start the wizard from that row, or from Internationalize a project at the top of the page.

Localization

The Localization part lists every internationalized project with its source language, its languages, its strings, and one bar for how much is translated. The small globe beside each project carries one bead per language: green when the language is complete, a teal ring when strings are missing or changed, and amber when some strings are broken.

Globalization

Ready every project for every market: code that works in any language and culture, then its translations.

2 projects · 6 languages · 135 strings waiting

InternationalizationLocalization
  • Storefront
    English source · 5 languages · 1,240 strings
    97.2%
    135 strings waiting
  • Help center
    Swedish source · 2 languages · 318 strings
    100%
    Every language complete

1 more project is not internationalized yet.

Globalization → Localization: each internationalized project's languages as beads round a small globe, with how much is translated and what still needs work. Illustrative data.

Opening a project opens its workbench.

Who does what

Everyone who can read a project sees its Globalization pages. Owners and admins run the wizard, create fix tasks, translate, edit strings and change settings. Which findings of the Globalization check send a change back is set in Quality Control.