Skip to content

Simplify config flow UI text#148

Open
florianhorner wants to merge 3 commits intofredck:masterfrom
florianhorner:ui-text-overhaul
Open

Simplify config flow UI text#148
florianhorner wants to merge 3 commits intofredck:masterfrom
florianhorner:ui-text-overhaul

Conversation

@florianhorner
Copy link

Summary

Rewrites the config flow UI text across all 3 translation files (en, pt-BR, sk) to be concise and scannable:

  • Shorter labels: "Device name" → "Name", "Controlled lights" → "Select lights", "Brightness mapping" → "Brightness curve"
  • Trimmed descriptions: Verbose paragraph-length helper text replaced with one-line tooltips
  • Removed filler: "Please provide a name for the Lightener device you are creating" → field label speaks for itself
  • Fixed Slovak: Untranslated English string "Current brightness" now properly translated

Before vs After (English)

Element Before After
Step 1 title "Create a Lightener device" "New Lightener device"
Name hint 40-word paragraph "A room or area name works best, e.g. "Living Room""
Light selector label "Select the light entities to be controlled by this Lightener device" "Lights to control"
Mapping helper 50-word paragraph "One mapping per line as group:light. Example: "60:100" means at 60% group brightness, this light reaches 100%."

No Python changes — purely translation/copy improvements.

Context

This is a low-risk incremental step toward the broader UX improvements discussed in #147 and #117. While those issues call for structural changes (visual curve editor, single-screen config), this PR reduces cognitive load in the existing flow by cleaning up the copy.

Notes

  • pt-BR and sk translations are best-effort — native speaker review welcome
  • All placeholder variables ({light_name}, {current_brightness}, {error_entry}) preserved
  • JSON structure unchanged; no config_flow.py modifications

Test plan

  • Install integration, run config flow — verify all 3 steps render correctly
  • Edit an existing Lightener device via options flow — verify labels match
  • Trigger validation error on brightness mapping — verify error message renders with {error_entry} placeholder
  • Switch HA language to pt-BR and sk — verify translations render

🤖 Generated with Claude Code

Florian Horner and others added 3 commits March 23, 2026 19:09
Rewrite verbose, tutorial-style descriptions into concise, scannable
UI copy. Strip decorative language, shorten labels, and move detailed
explanations into data_description tooltips. Fix untranslated English
string in Slovak translation.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Native speaker contribution — reviewed by a German-speaking
technical writer.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
The previous rewrite dropped {light_name} from the tooltip text,
losing context about which light the example refers to. Important
when configuring many lights sequentially (fredck#117).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
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.

1 participant