Skip to content

fix: translate missing English settings-tour steps#572

Merged
pancacake merged 2 commits into
HKUDS:devfrom
IliaAvdeev:fix/settings-tour-en-placeholders
Jun 19, 2026
Merged

fix: translate missing English settings-tour steps#572
pancacake merged 2 commits into
HKUDS:devfrom
IliaAvdeev:fix/settings-tour-en-placeholders

Conversation

@IliaAvdeev

Copy link
Copy Markdown

Description

Three of the eleven settings-tour steps shipped with placeholder values equal to their translation key, so the English onboarding tour rendered raw keys instead of copy. The Appearance (step 1), Status (step 2) and Tools (step 10) steps showed settingsTour.appearance.title, settingsTour.status.desc, etc. directly to the user.

Step Key Before After
1 settingsTour.appearance.title settingsTour.appearance.title Appearance
1 settingsTour.appearance.desc settingsTour.appearance.desc Choose the visual theme and interface language — changes apply immediately.
2 settingsTour.status.title settingsTour.status.title Status
2 settingsTour.status.desc settingsTour.status.desc Check the health of the backend and each service at a glance. Shows Pending when your draft diverges from the runtime.
10 settingsTour.tools.title settingsTour.tools.title Tools
10 settingsTour.tools.desc settingsTour.tools.desc Toggle the user-selectable tools here; locked tools mount automatically when the chat agent needs them.

The other 8 steps were already translated, and the zh locale had all 11 — only the English copy for these three was left as a TODO. New copy mirrors the existing zh translations and the tone of the already-translated steps.

Root cause: introduced when the settings tour landed (90a2c14c, v1.4.0-beta follow-ons) — the commit that added all settingsTour.* keys filled in 8 steps and left 3 as key: key placeholders. i18n:parity didn't catch it because the keys exist in both locales; only the values were untranslated.

Related Issues

  • N/A — no existing issue (searched open/closed issues & PRs; none filed for this).

Module(s) Affected

  • agents
  • api
  • config
  • core
  • knowledge
  • logging
  • services
  • tools
  • utils
  • web (Frontend)
  • docs (Documentation)
  • scripts
  • tests
  • Other: ...

Checklist

  • I have read and followed the contribution guidelines.
  • My code follows the project's coding standards.
  • I have run pre-commit run on the changed files — all hooks pass.
  • I have added relevant tests for my changes.
  • I have updated the documentation (if necessary).
  • My changes do not introduce any new security vulnerabilities.

Additional Notes

Adds web/tests/i18n-placeholders.test.ts: scans every English locale file and fails when a namespaced identifier key (lowercase dotted, e.g. settingsTour.*) has a value identical to its key — the exact shape of this bug. Plain-English keys ("Back") and proper nouns ("Chart.js", starts uppercase) are excluded, so there are no false positives. Verified it flags all 6 placeholders on the pre-fix file and passes on the fix.

Testing: web/tests node suite 139/139 pass (incl. 2 new); npm run i18n:parity OK; rebuilt the Docker image and confirmed the production .next bundle serves the real strings with no remaining placeholder values.

Screenshots

Step 1 — Appearance Step 2 — Status Step 10 — Tools
Before image image image
After image image image

@pancacake
pancacake merged commit 1db0abc into HKUDS:dev Jun 19, 2026
11 checks passed
vaskoyudha added a commit to vaskoyudha/deeptutor-for-programmer-fork that referenced this pull request Jul 25, 2026
…ders

# Conflicts:
#	web/locales/en/app.json
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants