Merge branch 'master' into new-ui-changes

Author: quirky-bluejay

discord_slash/client.py

@@ -327,6 +327,10 @@ def add_slash_command(self,
         """
         Registers slash command to SlashCommand.
 
+        .. warning::
+            Just using this won't register slash command to Discord API.
+            To register it, check :meth:`.utils.manage_commands.add_slash_command` or simply enable `sync_commands`.
+
         :param cmd: Command Coroutine.
         :type cmd: Coroutine
         :param name: Name of the slash command. Default name of the coroutine.

discord_slash/context.py

@@ -72,7 +72,7 @@ def guild(self) -> typing.Optional[discord.Guild]:
         return self.bot.get_guild(self.guild_id) if self.guild_id else None
 
     @property
-    def channel(self) -> typing.Optional[typing.Union[discord.abc.GuildChannel, discord.abc.PrivateChannel]]:
+    def channel(self) -> typing.Optional[typing.Union[discord.TextChannel, discord.DMChannel]]:
         """
         Channel instance of the command invoke.
 

docs/faq.rst

@@ -27,11 +27,11 @@ If you want your commands automatically registered, set ``sync_commands`` to ``T
 
    from discord_slash import SlashCommand
    
-   slash = SlashCommand(client, auto_register=True)
+   slash = SlashCommand(client, sync_commands=True)
 
 Or, if you prefer to have more control, you can use :mod:`.utils.manage_commands`.
 
-Or, you can made requests directly to Discord API, read the `docs <https://discord.com/developers/docs/interactions/slash-commands#registering-a-command>`_.
+Or, you can make requests directly to Discord API, read the `docs <https://discord.com/developers/docs/interactions/slash-commands#registering-a-command>`_.
 
 Add the command to your bot
 ---------------------------
@@ -44,17 +44,9 @@ For normal slash command, use :meth:`.client.SlashCommand.slash`, and for subcom
 How to delete slash commands?
 *****************************
 
-You can enable auto deletion of unused commands by setting ``auto_delete`` to ``True`` at :class:`.client.SlashCommand`.
+If ``sync_commands`` is set to ``True``, commands will automatically be removed as needed.
 
-.. code-block:: python
-   
-   from discord_slash import SlashCommand
-   slash = SlashCommand(auto_delete = True)
-
-.. note::
-   This will make a request for **every** single guild your bot is in.
-
-Or you can do it manually by this methods:
+However, if you are not using ``sync_commands`` you can do it manually by this methods:
 
 * Deleting a single command with :meth:`utils.manage_commands.remove_slash_command`
 * Deleting all commands using :meth:`utils.manage_commands.remove_all_commands`
@@ -124,4 +116,4 @@ Pretty much anything from the discord's commands extension doesn't work, also so
 
 Any more questions?
 *******************
-Join the `discord server <https://discord.gg/KkgMBVuEkx>`_ and ask in ``#questions``!
+Join the `discord server <https://discord.gg/KkgMBVuEkx>`_ and ask in ``#questions``!