From a2b241446ed36cb848b5eb0c3a7a5d96ba4939ff Mon Sep 17 00:00:00 2001
From: Rapptz <rapptz@gmail.com>
Date: Sat, 18 Jan 2020 19:57:47 -0500
Subject: [PATCH] [commands] Document BucketType separately

---
 discord/ext/commands/core.py | 12 ++----------
 docs/ext/commands/api.rst    | 32 ++++++++++++++++++++++++++++++++
 2 files changed, 34 insertions(+), 10 deletions(-)

diff --git a/discord/ext/commands/core.py b/discord/ext/commands/core.py
index 97c2634ce..3e05014f6 100644
--- a/discord/ext/commands/core.py
+++ b/discord/ext/commands/core.py
@@ -1776,15 +1776,7 @@ def cooldown(rate, per, type=BucketType.default):
     of times in a specific time frame. These cooldowns can be based
     either on a per-guild, per-channel, per-user, per-role or global basis.
     Denoted by the third argument of ``type`` which must be of enum
-    type ``BucketType`` which could be either:
-
-    - ``BucketType.default`` for a global basis.
-    - ``BucketType.user`` for a per-user basis.
-    - ``BucketType.guild`` for a per-guild basis.
-    - ``BucketType.channel`` for a per-channel basis.
-    - ``BucketType.member`` for a per-member basis.
-    - ``BucketType.category`` for a per-category basis.
-    - ``BucketType.role`` for a per-role basis (added in v1.3.0).
+    type :class:`.BucketType`.
 
     If a cooldown is triggered, then :exc:`.CommandOnCooldown` is triggered in
     :func:`.on_command_error` and the local error handler.
@@ -1797,7 +1789,7 @@ def cooldown(rate, per, type=BucketType.default):
         The number of times a command can be used before triggering a cooldown.
     per: :class:`float`
         The amount of seconds to wait for a cooldown when it's been triggered.
-    type: ``BucketType``
+    type: :class:`.BucketType`
         The type of cooldown to have.
     """
 
diff --git a/docs/ext/commands/api.rst b/docs/ext/commands/api.rst
index d16cb8055..a8f7e0012 100644
--- a/docs/ext/commands/api.rst
+++ b/docs/ext/commands/api.rst
@@ -111,6 +111,38 @@ Help Commands
 .. autoclass:: discord.ext.commands.Paginator
     :members:
 
+Enums
+------
+
+.. class:: discord.ext.commands.BucketType
+
+    Specifies a type of bucket for, e.g. a cooldown.
+
+    .. attribute:: default
+
+        The default bucket operates on a global basis.
+    .. attribute:: user
+
+        The user bucket operates on a per-user basis.
+    .. attribute:: guild
+
+        The guild bucket operates on a per-guild basis.
+    .. attribute:: channel
+
+        The channel bucket operates on a per-channel basis.
+    .. attribute:: member
+
+        The member bucket operates on a per-member basis.
+    .. attribute:: category
+
+        The category bucket operates on a per-category basis.
+    .. attribute:: role
+
+        The role bucket operates on a per-role basis.
+
+        .. versionadded:: 1.3.0
+
+
 .. _ext_commands_api_checks:
 
 Checks