Show one fixed subtitle for each Settings row and fix localized labels

Merged
AG
20d ago
+3124-10017

Part of #12958.

Summary

Settings rows change their subtitle when the control value changes. A toggle shows one sentence when on and another when off. A picker explains only the selected option. Many off-state subtitles only ask people to turn the setting on.

This PR gives 55 toggle rows and 10 picker rows one fixed subtitle each. A toggle subtitle states what the setting does when on. A picker subtitle starts with "Choose" and explains the options. Status text, such as the organization-managed notice, still replaces the subtitle when it applies.

The new strings are localized in all nine app languages. The PR also corrects 194 existing localized titles and labels across 95 keys that used the wrong word. For example, Spanish called Feed "Canal" (channel), and Simplified Chinese called the cmux Dock 程序坞, the name of the macOS Dock. scripts/localization-allowed-omissions.json records each label where Feed or Dock stays in English.

These comments list the old text, new text, and Apple HIG rule for each row:

Testing

  • CMUX_DEV_BACKEND_MODE=local ./scripts/reload.sh --tag settings-text built and launched 4b120bcc74 on macOS 27.0. The screenshots and recording below come from that build. The later commit 505e7081ce changes only a test comment.
  • python3 scripts/localization_catalog.py check reported 0 parity errors across 9 catalogs and 9 locales.
  • swift test --package-path Packages/macOS/CmuxSettingsUI passed 196 tests.
  • cmuxUITests/SettingsAutomationBehaviorUITests.swift is updated for the fixed subtitles but was not run. No PR job runs cmuxUITests.
  • Language-model review checked the translations. No native speaker has reviewed them.

Demo Video

AppApp (Japanese)Automation
App paneApp pane in JapaneseAutomation pane

The recording shows clicks on App, Terminal, Sidebar, Browser, and Automation in Settings.

https://github.com/user-attachments/assets/7fecf8e3-b30a-4585-b80a-07373e53f94b

Checklist

  • Behavior changes have added or updated tests, or Testing says why not
  • UI, settings, menu, schema, help-text or user-facing docs change: localization audited, and the result is stated above
  • Docs and changelog updated if needed
  • Reviewed with a subagent before merge (cmux-review), and all bot and human review comments resolved

Summary by CodeRabbit

  • Changed
    • Settings toggle and picker rows now keep their explanatory subtitles consistent as selections change, making option descriptions easier to scan across settings, automation, browser, sidebar, and other sections.
    • Updated explanations for folder access, socket access levels, and workspace naming.
    • Corrected localized wording for Settings titles and Feed, Dock, and Cloud Machines labels.