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

34 lines
2.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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
- [x] English message catalog and `t` helper (M1.11)
- [x] Lint rule against bare template strings (M1.11)
- [x] Every UI string in `ui/src` from the catalog: templates, `title` and `aria-label` attributes, notices, frontend error texts (M1.11)
- [x] 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)
- [x] 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)
- [x] 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 |