Lutra/docs/localization-parity.md
danny 33a7185d75
Some checks are pending
ci / ci (macos-15) (push) Waiting to run
ci / ci (ubuntu-24.04) (push) Waiting to run
ci / ci (windows-2025) (push) Waiting to run
F1: cosmetics: regex error reason, one date format, Close Tab
- Find shows a bad regex as "invalid pattern: unclosed group": the search
  crate keeps only the parser's reason, the UI drops the invalid-params
  prefix (userMessage).
- Dates read YYYY-MM-DD / YYYY-MM-DD HH:mm in local time everywhere
  (i18n formatDate/formatDateTime): Log, stash list, blame, recovery.
- buffer.close is "Close Tab" in the palette as in the menu; an engine test
  keeps palette labels starting with their menu item's wording.
- Docs: architecture, install (Jump List), localization parity, checklist.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-02 19:31:43 +01:00

2.3 KiB
Raw Blame History

Localization checklist

Status: English catalog covers 100% of UI strings (M1.11); German not started · Last updated: 2026-11-02

Language Code Status Translated
English en source catalog (ui/src/i18n/en.json) 100% of UI strings (80 keys, measured by the catalog test)
German de planned (G14) 0%

All interface strings go through the message catalog: t(key, params?) from ui/src/i18n, flat dotted keys grouped by area (app.*, project.*, editor.*, common.*), {name} placeholders. Lint (vue/no-bare-strings-in-template, error) rejects bare text in templates; a Vitest scan checks that every key passed to t exists in en.json and that the catalog has no unused keys.

Checklist

  • English message catalog and t helper (M1.11)
  • Lint rule against bare template strings (M1.11)
  • Every UI string in ui/src from the catalog: templates, title and aria-label attributes, notices, frontend error texts (M1.11)
  • Notification texts: engine and host notifications carry a messageKey with params; all 12 notification message keys are in the catalog (M1.7, M1.12), message is only the English fallback
  • Engine messages: EngineError.message and other texts the engine sends are English only; they need message keys and params (G14)
  • Setting labels, descriptions, section names and enum value names from settings.list in the catalog (M1.9b)
  • Language switch through ui.language; the catalog becomes reactive (G14)
  • One date format everywhere until G14 (C9 F1): YYYY-MM-DD and YYYY-MM-DD HH:mm in local time (i18n › formatDate, formatDateTime) in the Log, stash list, blame and the recovery dialog, instead of the system locale's format next to English text
  • Plural forms and number/date formatting per locale (G14)
  • German catalog (G14)
  • Native menus and dialogs of the desktop shell (folder picker title, app menu) (G14)

Revision history

Date Change Summary
2026-11-02 minor C9 F1: one documented date format; path refusals from the engine (two catalog keys removed)
2026-10-16 minor M1.9b: settings keys, key count 80
2026-10-16 minor M1.12: notification keys, key count 46
2026-10-15 minor M1.11: English catalog, lint rule, checklist; engine-message gap
2026-10-13 major Baseline