duo-localization

Installation
SKILL.md

Duolingo Localization — Map of Content

Translation is the cheapest and least important part of shipping to a market that is not yours. The expensive parts are structural: components that encode a reading direction, containers sized for your source string, defaults that decide who sees what, and copy that works through connotation rather than meaning. Most localization failures are not mistranslations — they are correct strings inside a product that still assumes your user.

Two ideas run through all of it. First, comprehension beats correctness — the goal is the user reaching the next screen, not a string a reviewer would approve. Second, the market you learned your product in taught you things that are not true elsewhere, so every default, every winning test and every cohort assumption is suspect until re-checked locally.

Scan the descriptions, follow only the [[wikilinks]] you need.

Write for the person who is actually reading

  • [[references/localize-into-the-register-people-speak]] — ship the words users say, including loanwords; review every screen against your least software-fluent user; open by inventorying what they already know.
  • [[references/rewrite-rather-than-default-the-assumption]] — when grammar forces you to assert something about the user, rephrase around it rather than picking a default, and prefer already-neutral words to invented ones.
  • [[references/localize-to-a-consumption-budget]] — the constraint is the consumer's processing rate, so rank information by importance and preserve intent rather than words.

The product, not the strings

  • [[references/reading-direction-is-a-component-problem]] — pagers, swipes and orderings encode direction; the platform primitive you need may never have been fixed, so budget to build it.
  • [[references/layout-overrides-your-content-policy]] — containers sized for the source string quietly revert your content decisions, and a denser script can buy explanation that a longer one cannot.
Installs
7
GitHub Stars
5
First Seen
Sep 22, 2026