Add rate limiting examples [ci skip]

.yardopts

@@ -9,4 +9,5 @@ CONTRIBUTING.md
 LICENSE.md
 README.md
 examples/Configuration.md
+examples/RateLimiting.md
 examples/Update.md

examples/RateLimiting.md

@@ -0,0 +1,23 @@
+# Rate Limits
+
+Here's an example of how to handle rate limits:
+
+```ruby
+require 'twitter'
+
+MAX_ATTEMPTS = 3
+num_attempts = 0
+begin
+  num_attempts += 1
+  retweets = client.retweeted_by_user("sferik")
+rescue Twitter::Error::TooManyRequests => error
+  if num_attempts <= MAX_ATTEMPTS
+    # NOTE: Your process could go to sleep for up to 15 minutes but if you
+    # retry any sooner, it will almost certainly fail with the same exception.
+    sleep error.rate_limit.reset_in
+    retry
+  else
+    raise
+  end
+end
+```