[i18n] 94 devTools keys missing Spanish (commonCommandsHelper command catalog) #420

Closed
opened 2026-07-05 21:37:12 +00:00 by spikerj · 0 comments
Owner

Verified finding (en↔es key diff across all i18n scopes)

Scope en keys es keys missing in es
assets/i18n/ (root) 6980 7063 0
assets/i18n/keycloakAdmin/ 733 734 0
assets/i18n/devTools/ 2580 2489 94 ⚠️

The 94 untranslated devTools keys are all under commonCommandsHelper.catalog.* — the terminal command-reference feature:

  • ...categories.{fileOps,systemInfo,packageMgmt,networking,permissions,processMgmt,archives,shortcuts,advanced}.name (category labels)
  • ...commands.{ls,cd,…}.description and ...commands.{ls,cd,…}.examples

Spanish-mode students opening the command helper get English fallback for these entries (or the raw key). The rest of devTools (2489 keys) is translated, so this reads as a feature that shipped en-only.

Fix guidance (important — per #400)

Translate via the _review machine-translation workflow (pnpm i18n tooling), but preserve command syntax verbatim in English:

  • Translate: category .name labels and .description prose ("List directory contents" → "Muestra el contenido del directorio").
  • Do NOT translate the actual commands/flags/paths inside .examples (ls -la, cd .., chmod +x) — keep them English, exactly like #400 (translated code/syntax is a defect). This is why it shouldn't be a blind machine pass.

Mark new es entries with the _review marker for human verification per the i18n convention.

Severity: Low–Medium (bilingual coverage gap on a real feature; English fallback means it's usable but not localized). Scope: frontend only (projects/spikersoft/src/assets/i18n/devTools/es.json).

## Verified finding (en↔es key diff across all i18n scopes) | Scope | en keys | es keys | missing in es | |---|---|---|---| | `assets/i18n/` (root) | 6980 | 7063 | **0** ✅ | | `assets/i18n/keycloakAdmin/` | 733 | 734 | **0** ✅ | | `assets/i18n/devTools/` | 2580 | 2489 | **94** ⚠️ | The 94 untranslated devTools keys are all under **`commonCommandsHelper.catalog.*`** — the terminal command-reference feature: - `...categories.{fileOps,systemInfo,packageMgmt,networking,permissions,processMgmt,archives,shortcuts,advanced}.name` (category labels) - `...commands.{ls,cd,…}.description` and `...commands.{ls,cd,…}.examples` Spanish-mode students opening the command helper get **English fallback** for these entries (or the raw key). The rest of devTools (2489 keys) is translated, so this reads as a feature that shipped en-only. ## Fix guidance (important — per #400) Translate via the `_review` machine-translation workflow (`pnpm i18n` tooling), but **preserve command syntax verbatim in English**: - ✅ Translate: category `.name` labels and `.description` prose ("List directory contents" → "Muestra el contenido del directorio"). - ⛔ Do **NOT** translate the actual commands/flags/paths inside `.examples` (`ls -la`, `cd ..`, `chmod +x`) — keep them English, exactly like #400 (translated code/syntax is a defect). This is why it shouldn't be a blind machine pass. Mark new es entries with the `_review` marker for human verification per the i18n convention. **Severity:** Low–Medium (bilingual coverage gap on a real feature; English fallback means it's usable but not localized). **Scope:** frontend only (`projects/spikersoft/src/assets/i18n/devTools/es.json`).
Sign in to join this conversation.