Docs feedback: Keyboard shortcuts information for Web IDE is out of date and difficult to find in web searches and needs SSOT
Problem to solve
It was extremely difficult to learn the keyboard shortcuts in Web IDE to do line comments for multiple lines selected in the Web IDE. All roads led to https://docs.gitlab.com/ee/user/shortcuts.html#web-ide, (Difficulty #1) which appears to be very out of date with the ones shown on a screen shot for Web IDE Command Palette here: https://docs.gitlab.com/ee/user/project/web_ide/#command-palette.
Difficulty #2 is that the screen shot appears to be the only (incomplete) list of what is available in Web IDE - which is likely why it is not easily found by web searches.
Difficulty #3 is that Mac Laptop keyboards don't have an F1 key to bring up command palette - so interactive discoverability of the keyboard commands is hampered further - making web searchable docs even more beneficial.
Further details
Proposal
Create:
- An SSOT for this information (in one of the above pages)
- That is web searchable (lists all keyboard short cuts and descriptions)
- Crosslink the above pages so the SSOT is findable from both locations.
Who can address the issue
Documentation update skills.