Why
A developer adding a ,-prefixed keymap (e.g. ,w) will create a binding that is unreachable in normal mode — because , is remapped to enter command mode — without any in-code warning to prevent this.
Current state
lua/config/plugins/navigating.lua remaps , to enter command mode (:) and : to repeat the last f/t motion (,). This is a non-obvious, high-impact swap: , is a common keymap leader prefix and : is the default Vim command entry key. Neither mapping has a comment explaining the ergonomic rationale for the swap. There is no warning that , cannot be used as a keymap prefix after this remapping.
Ideal state
- The
,/: swap block includes a comment explaining the rationale, e.g.: -- Ergonomic swap: , enters command mode (right-hand pinky on semicolon is awkward); : repeats last f/t motion.
- A follow-up comment warns:
-- NOTE: , is no longer available as a keymap prefix in normal mode.
Out of scope
Changing the keymaps themselves; adding or removing other navigation bindings.
Starting points
lua/config/plugins/navigating.lua — the ,/: swap block
QA plan
- Open
navigating.lua and locate the , and : mappings — expect a rationale comment and a prefix-warning comment on or adjacent to both lines.
Done when
The ,/: swap block has an inline comment explaining the ergonomic rationale and a warning that , cannot be used as a normal-mode keymap prefix.
Why
A developer adding a
,-prefixed keymap (e.g.,w) will create a binding that is unreachable in normal mode — because,is remapped to enter command mode — without any in-code warning to prevent this.Current state
lua/config/plugins/navigating.luaremaps,to enter command mode (:) and:to repeat the lastf/tmotion (,). This is a non-obvious, high-impact swap:,is a common keymap leader prefix and:is the default Vim command entry key. Neither mapping has a comment explaining the ergonomic rationale for the swap. There is no warning that,cannot be used as a keymap prefix after this remapping.Ideal state
,/:swap block includes a comment explaining the rationale, e.g.:-- Ergonomic swap: , enters command mode (right-hand pinky on semicolon is awkward); : repeats last f/t motion.-- NOTE: , is no longer available as a keymap prefix in normal mode.Out of scope
Changing the keymaps themselves; adding or removing other navigation bindings.
Starting points
lua/config/plugins/navigating.lua— the,/:swap blockQA plan
navigating.luaand locate the,and:mappings — expect a rationale comment and a prefix-warning comment on or adjacent to both lines.Done when
The
,/:swap block has an inline comment explaining the ergonomic rationale and a warning that,cannot be used as a normal-mode keymap prefix.