Multiselection hints are too obscure
Actual Situation
-
<space> to select- select what? -
<a> to toggle- toggle what? -
<i> to invert- invert what?
Initially, I thought that all these actions refer to a (one) selection. But in this case, all these actions would do the same thing.
Only after trying and experimenting with a toy template I understood everything.
Desired Situation
Let's address this bit by bit.
What actions do:
-
<space> to select- toggles a single option under the arrow. -
<a> to toggle- either:- Selects every option.
- Deselects every option.
-
<i> to invert- inverts current assignments. What was selected become deselected, what was deselected became selected.
Scopes:
-
<space> to select- single choice. -
<a> to toggle- all choices. -
<i> to invert- all choices.
Proposed solution
Maybe rewrite it like this:
-
<space> to select-<space> toggle -
<a> to toggle-<a> select all -
<i> to invert-<i> invert selection
If we came to consensus, I can make a PR
Maybe also <enter> confirm
Nice suggestion, thanks!
I would slightly change it to:
-
<space> (un)select -
<a> (un)select all -
<i> invert selection
Also yes to <enter> confirm.
Not so fast. This is a problem in underlying library questionary.
Aha! It actually has instruction parameter which we can use: https://questionary.readthedocs.io/en/stable/pages/types.html#questionary.checkbox