Hello World

Your localisation playbook

All chapters

Part 7 · Putting it together

Your localisation playbook

Chapter 27 16 min read 15 sections

Someone has decided the product is launching in a new market. Maybe it's a new language, maybe it's another English-speaking country, and maybe the date is already in a slide deck. Now it's on your desk, and the question is where to start.

The rest of this book is organised by topic, because that's how you look things up. This chapter is organised by order. It's the plan I'd follow to localise an existing app, step by step, with a pointer to the chapter that covers each step in depth. If your product doesn't exist yet, skip to "Starting from scratch", because your job is much easier.

<title id="g1-title">The localisation playbook as a route</title> Eleven phases along a winding route: decide, audit, foundations, strings, formats and forms, layout, beyond the browser, test, translate, launch, and keep going. Deciding comes first and keeping going never ends. 0 Decide goals, markets, locales 1 Audit find what will break 2 Foundations a locale on every user 3 Strings out of the templates 4 Formats and forms Intl, money, names 5 Layout room to grow 6 Beyond the browser emails, jobs, PDFs 7 Test pseudo-locale first 8 Translate AI draft, human review 9 Launch URLs, payments, support 10 Keep going every release NEW FEATURES go round again

Each phase below has three parts. Do is the work. Done when is how you know you can move on. Read is where the detail lives.

You don't have to finish every phase before starting the next, and on a big app you won't. But the order matters. Fixing the foundations before you extract strings, and testing with fake translations before you pay for real ones, saves you doing the expensive work twice.

I won't guess how long yours will take, because that depends on the codebase more than anything else. But I'd always start the same way: with the audit in phase 1. Search the code for hard-coded strings, hand-rolled date formats and money stored as floats, so you know the size of the job before anyone gives an estimate.

Keep reading

The rest of this chapter is for readers of the book

Get the book to read the rest of this chapter and every other one, the field guide and the glossary, and to download the whole book as a PDF.

Still to come in this chapter

  • Decide before you write any code
  • Phase 1: Audit what you've got
  • Phase 2: Lay the foundations
  • Phase 3: Get the strings out
  • Phase 4: Fix formats and forms
  • Phase 5: Make the layout flexible
  • Phase 6: Look beyond the browser
  • Phase 7: Pseudolocalise and test
  • Phase 8: Translate and review
  • Phase 9: Launch
  • Phase 10: Keep going
  • Starting from scratch
  • The smallest useful first step
  • The master checklist
  • Further reading