friendo-bot icon indicating copy to clipboard operation
friendo-bot copied to clipboard

make sure every command's help can allow a user to use that command with no other context

Open fisher60 opened this issue 4 years ago • 2 comments

Summary

There is a big issue with the bot being documented, many commands are improperly documented.

I.e the flip command does not say anywhere that the command is .flip heads when doing .help fun, a user should be able to understand how to use each command in a cog by using .help <cog name>.

Implementation

Someone needs to go through all the cogs and the help command to ensure every command is usable from invoking .help <cog name>. This would mostly be by adding usage tips.

We could perhaps enhance the help command to include the usage attribute (if it does not already) and make usage mandatory for each command.

fisher60 avatar Dec 04 '20 08:12 fisher60

I couldn't get what's the actual functionality you are asking for..?

Ajay-Singh-Rana avatar Apr 05 '21 08:04 Ajay-Singh-Rana

@Ajay-Singh-Rana Hello, this issue is a bit larger and tedious. This is mostly a quality of life/user experience update.

Many help commands are not very clear and are missing some explanation of how to use the command. Some commands are also inconsistent, lacking important kwargs. This issue requires someone to go through all the available commands and ensure that a user could use the help command to understand all other commands, without needing any additional help.

I.e a user should be able to join the server and type any .help <command/cog> and be able to understand how to use this without being confused.

fisher60 avatar Apr 06 '21 18:04 fisher60