Documentation for the whole list of available commands

[ramya-rao-a]

https://code.visualstudio.com/docs/extensionAPI/vscode-api-commands lists a couple of commands.

The keyboard shortcut file has another list of available commands. This one is just a list, no docs, no description.

Can we have a page in our docs with the whole list + description?

[gregvanl]

Closing as the new keyboard shortcut editor lists all commands, both Command Palette name and command id. It allows search and filtering for easy discovery.

[jVanZwieten]

OK, but for example, what's the difference between acceptSelectedSuggestion and accepSelectedSuggestionOnEnter? It would just be really nice to have some kind of description, esp in metadata like methods, for the commands so that we can figure out the answer to that kind of question.

[phil294]

@gregvanl these aren't documentation, it is a mere list of commands. For example, it is impossible to find out the available args for any of these.

[taylorstutts]

Because the keyboard shortcut editor is where I always look for API documentation

[sebbean]

what about commands that don't have keyboard shortcuts? ie: "Show next window tab"

[ramya-rao-a]

Re-opening to get thoughts from the @Microsoft/vscode team

[octref]

I think we should find a way to auto-generate the docs for commands (same for API doc, but both need better presentations on website).
Static analysis of the codebase to find all command registration can be tricky to implement, but we might introduce a way to let command registry dump all data into a JSON and we generate HTML for the website from it.