[docs] Add async with documentation for Client

Co-authored-by: Rapptz <[email protected]>

discord/client.py

@@ -117,6 +117,14 @@ class Client:
     r"""Represents a client connection that connects to Discord.
     This class is used to interact with the Discord WebSocket and API.
 
+    .. container:: operations
+
+        .. describe:: async with x
+
+            Asynchronously initialises the client and automatically cleans up.
+
+            .. versionadded:: 2.0
+
     A number of options can be passed to the :class:`Client`.
 
     Parameters

discord/ext/commands/bot.py

@@ -1387,6 +1387,14 @@ class Bot(BotBase, discord.Client):
     a :class:`~discord.app_commands.CommandTree` and is automatically set upon
     instantiating the class.
 
+    .. container:: operations
+
+        .. describe:: async with x
+
+            Asynchronously initialises the bot and automatically cleans up.
+
+            .. versionadded:: 2.0
+
     Attributes
     -----------
     command_prefix
@@ -1457,6 +1465,14 @@ class Bot(BotBase, discord.Client):
 class AutoShardedBot(BotBase, discord.AutoShardedClient):
     """This is similar to :class:`.Bot` except that it is inherited from
     :class:`discord.AutoShardedClient` instead.
+
+    .. container:: operations
+
+        .. describe:: async with x
+
+            Asynchronously initialises the bot and automatically cleans.
+
+            .. versionadded:: 2.0
     """
 
     pass

discord/shard.py

@@ -308,6 +308,14 @@ class AutoShardedClient(Client):
     if this is used. By default, when omitted, the client will launch shards from
     0 to ``shard_count - 1``.
 
+    .. container:: operations
+
+        .. describe:: async with x
+
+            Asynchronously initialises the client and automatically.
+
+            .. versionadded:: 2.0
+
     Attributes
     ------------
     shard_ids: Optional[List[:class:`int`]]