This would render just the spoken command and not the docstring or description. This could either be in the form of a list or as an option to the command-table directive that only renders the first column of the table. If the latter it could also be implemented so that it could be toggleable.
There are a few reasons this pattern might be desirable the first is that it would allow for removing visual noise and saving space for list of commands who's action is evident from the spoken command. This would be useful in creating 'cheatsheet' like documentation, in combination with sphinx-design etc..., a good list this could be used for is the editor actions/vscode.
The other main reason is that it would also allow for displaying the list without the same discrimination being printed for most of the items in a list such Such as: jetbrain where most of them just say "Send a command to Jetbrains product".
This would render just the spoken command and not the docstring or description. This could either be in the form of a list or as an option to the command-table directive that only renders the first column of the table. If the latter it could also be implemented so that it could be toggleable.
There are a few reasons this pattern might be desirable the first is that it would allow for removing visual noise and saving space for list of commands who's action is evident from the spoken command. This would be useful in creating 'cheatsheet' like documentation, in combination with sphinx-design etc..., a good list this could be used for is the editor actions/vscode.
The other main reason is that it would also allow for displaying the list without the same discrimination being printed for most of the items in a list such Such as: jetbrain where most of them just say "Send a command to Jetbrains product".