Guide in the rail makes the studio explain itself - #758
Merged
Merged
Conversation
added 2 commits
October 4, 2026 17:57
Nothing in the studio said what its controls do, and a new user has to press things to find out, which can start an extraction or delete a song. Guide, in the rail below Trash, turns help mode on, and a pill at the bottom says so. Pointing at a control, focusing it, or clicking it outlines it and shows a box beside it with the control's own label and what it does, in plain words. Nothing else is marked, so the screen stays calm. While help mode is on, presses are taken by it, so exploring never acts on the studio. Esc or Guide again turns it off. The box covers the top bar, the rail, the song list, every lane control (naming its instrument), the song facts, the waveforms and the bottom bar. Settings lists every option, tab by tab, in one line each. Texts are help.* keys in all ten languages. Closes #757
In help mode the box over a lane's M button was headed "M", and S, +
and the K box the same: the heading took the visible text first, and
for these it is one character. Someone who does not know what M means
learned nothing from the heading.
A visible text of one or two characters now gives way to the button's
full label ("Mute Drums", "Transpose Drums up one semitone"). The K box
has no label of its own, so it gets one: "Key of Drums", in all ten
languages.
Refs #757
Merged
thcp
added a commit
that referenced
this pull request
Oct 4, 2026
feat(help): Guide in the rail makes the studio explain itself Nothing in the studio said what its controls do, and a new user has to press things to find out, which can start an extraction or delete a song. Guide, in the rail below Trash, turns help mode on, and a pill at the bottom says so. Pointing at a control, focusing it, or clicking it outlines it and shows a box beside it with the control's own label and what it does, in plain words. Nothing else is marked, so the screen stays calm. While help mode is on, presses are taken by it, so exploring never acts on the studio. Esc or Guide again turns it off. The box covers the top bar, the rail, the song list, every lane control (naming its instrument), the song facts, the waveforms and the bottom bar. Settings lists every option, tab by tab, in one line each. Texts are help.* keys in all ten languages. Closes #757 fix(help): head a lane's M, S, + and K boxes with what they do In help mode the box over a lane's M button was headed "M", and S, + and the K box the same: the heading took the visible text first, and for these it is one character. Someone who does not know what M means learned nothing from the heading. A visible text of one or two characters now gives way to the button's full label ("Mute Drums", "Transpose Drums up one semitone"). The K box has no label of its own, so it gets one: "Key of Drums", in all ten languages. Refs #757
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
1 participant
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.
A new user can now find out what every control does without pressing it.
What changes
help.*keys in all ten languages. The box's title is each control's existing, already translated label.Keyboard shortcuts (L, K, space) still work in help mode; only presses are taken.
Testing
tests/e2e/help-mode.spec.mjs, 6 tests: on and off with Guide and Esc, the pill, a box under the control's own label, a lane control naming its instrument, a click that explains instead of acting (and acts again once help mode is off), the full Settings list, and every covered control resolving to a real title and text.uv.lockunchanged.The nine translations are mine and have not been read by a native speaker. pt-PT shows the Brazilian text.
Closes #757