Cut repeated and over-explained copy in help and across the views #123

Closed
opened 2026-10-25 02:48:03 -05:00 by ethan-hann · 0 comments
Owner

Much of the app's copy says the same idea twice in different words, or explains simple things at length. This shows in the help (How SavePoint works, the What's this? explanations, the tour) and throughout the views: helper text under fields, dialog bodies, notes after play, empty states and toasts.

Go through every catalog file (src/Savepoint.App/Localization/Assets/Lang/en/*.json) screen by screen and cut each string to what the player needs at that moment: one idea per sentence, no restating what a title or button already says, no explaining something the control makes obvious, and no repeating the same warning in a helper and a dialog. Keep what D44 requires (permanence stated in the title or the button, the plain-language vocabulary, a question button where a new concept needs one), and keep every fact a player needs to make a safe choice. Check the result in the running app at the default window size, since shorter copy changes layouts, and update the tests that pin exact strings.

Much of the app's copy says the same idea twice in different words, or explains simple things at length. This shows in the help (How SavePoint works, the What's this? explanations, the tour) and throughout the views: helper text under fields, dialog bodies, notes after play, empty states and toasts. Go through every catalog file (`src/Savepoint.App/Localization/Assets/Lang/en/*.json`) screen by screen and cut each string to what the player needs at that moment: one idea per sentence, no restating what a title or button already says, no explaining something the control makes obvious, and no repeating the same warning in a helper and a dialog. Keep what D44 requires (permanence stated in the title or the button, the plain-language vocabulary, a question button where a new concept needs one), and keep every fact a player needs to make a safe choice. Check the result in the running app at the default window size, since shorter copy changes layouts, and update the tests that pin exact strings.
ethan-hann added this to the 1.0 milestone 2026-10-25 02:48:03 -05:00
Sign in to join this conversation.
No milestone
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
ethan-hann/SavePoint#123
No description provided.