Make OpenStation settings easier to understand - #581
Open
nickhamze wants to merge 2 commits into
Open
Conversation
This was referenced Aug 12, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why this change
We reviewed every setting surfaced by the Settings Clarity run and found a recurring problem: the controls often say what they change, but not who the change affects, when it takes effect, what else it changes, or how to reverse it.
That makes ordinary choices feel riskier than they should. A person should not need to inspect the code—or learn by surprise—that a preference follows their WordPress account, a theme changes other preferences the first time it is selected, a native-window choice applies only when the app is opened again, or a reset reaches every Preferences tab.
The audit covered 137 settings. Of those, 129 are real OpenStation product settings and 8 are deliberately planted test-lab canaries. The canaries remain in the lab; this PR updates the product language only.
What changes
This pass focuses on the shared language problems that made otherwise straightforward settings hard to predict:
Representative examples:
What this PR does not claim to fix
This is intentionally a language-focused PR. The audit also found behavior bugs—failed-save rollback, rapid-toggle races, Spatial-layout placement, live opener refresh, ribbons that remain visible, and similar problems. Those need code fixes and are being tracked separately. The copy here does not disguise or close them.
The 16 findings from the audit
Every finding has its own destination now, so this PR does not become a catch-all bug report.
This PR fully resolves the wording or accessible-name problem in:
It improves the explanation, while leaving the remaining interaction decision open, in:
The behavior bugs remain separate:
Checks run
npm run lintnpm run typechecknpm run test:js— 4,260 tests passednpm run build