Switch help command

[modernNeo]

Description

Help Revamp

text command annotation example:

    @commands.command(
        brief="string that is displayed when shown in .help output",

        description='the description',
        help=(
            "Arguments:\n"
            "\tthe message: message to post to channel\n\n"
            "Example:\n"
            "\t.announce 'the example'"
        ),
        usage='"the message"'
    )

what is displayed:

slash command annotation example

    @app_commands.command(name="echo", description="repeats what the user said back at them")
    @app_commands.describe(string1="string to echo1")
    @app_commands.describe(string2="string to echo2")
    async def echo(self, interaction: discord.Interaction, string1: str, string2: str):

what is displayed

Permission Checking

text command example

@commands.has_any_role("Bot_manager", "Minions", "Moderator") # invoking user has any of these roles
@commands.has_role("Bot_manager") # invoking user has this role

@commands.check(user_can_manage_roles) # ensure that the invoking user has any of these permissions
def user_can_manage_roles(ctx):
    return ctx.author.guild_permissions.administrator or ctx.author.guild_permissions.manage_roles

slash command example

PR Checklist

These are the things you need to ensure are covered in your PR, otherwise the CODEOWNERS will not approve your PR, not matter how much you ping them to do so on the Discord

1. The description in the PR is a fair representation of what the PR is about.
2. The PR is fixing one thing and one thing only.
3. Logging. if you have N variables initialzed/used in your function, you should print all of them out to the log using logging module at least once or have a good reason why you arent.
4. If your PR is doing something like adding a new line or removing a new line, CODEOWNERS reserve the right to ask that you undo that change unless it was for a specific reason.
5. If you are adding a new command....document. Document the following things on help.json and the README.md
   1. The purpose of the command
   2. If the argument is called with any arguments.
      1. If it is called with any arguments, please either provide a good enough explanation of the arg that a user can tell what it will do before using the command. adding an example of how to call it with the args is not necessary but good practice.
6. If you are making a new Class of commands, add the class to bot.json following the convention already there.
7. Evidence of Testing. This one needs to be completed after the PR is opened. At that point, you will go on the channel on the CSSS Wall-E Test Server that was automatically created when the PR was opened and then test the following functionality. Once you had done so, you can leave a comment on the PR stating that you had done the necessary testing.
8. Please provide ways to test whatever you just modified on the bot in the Test Cases section so that future PRs can be tested to ensure they dont break your code when merging to master