From 8570bd2c9d644c82e69e4c3bbae3af24f95180e2 Mon Sep 17 00:00:00 2001
From: Daniel Nash <22755628+crazygmr101@users.noreply.github.com>
Date: Sun, 7 Jun 2020 03:15:51 -0500
Subject: Create cooldown.md

---
 bot/resources/tags/cooldown.md | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)
 create mode 100644 bot/resources/tags/cooldown.md

diff --git a/bot/resources/tags/cooldown.md b/bot/resources/tags/cooldown.md
new file mode 100644
index 000000000..a4e237872
--- /dev/null
+++ b/bot/resources/tags/cooldown.md
@@ -0,0 +1,22 @@
+**Cooldowns**
+
+Cooldowns are used in discord.py to rate-limit.
+ 
+```python
+from discord.ext import commands
+
+class SomeCog(commands.Cog):
+    def __init__(self):
+        self._cd = commands.CooldownMapping.from_cooldown(1.0, 60.0, commands.BucketType.user)
+
+    async def cog_check(self, ctx):
+        bucket = self._cd.get_bucket(ctx.message)
+        retry_after = bucket.update_rate_limit()
+        if retry_after:
+            # you're rate limited
+            # helpful message here
+            pass
+        # you're not rate limited
+```
+
+`from_cooldown` takes the amount of `update_rate_limit()`s needed to trigger the cooldown, the time in which the cooldown is triggered, and a [`BucketType`](discordpy.readthedocs.io/en/latest/ext/commands/api.html#discord.discord.ext.commands.BucketType).
-- 
cgit v1.2.3