Update and improve documentation for API.rate_limit_status

diff --git a/tweepy/api.py b/tweepy/api.py
index 96a804d0eb16049d60674104c4e95893e5d7a6cb..2e273e2f8e2c1e5a8b9a865fcc28fcc726512da2 100644 (file)
--- a/tweepy/api.py
+++ b/tweepy/api.py
@@ -3942,9 +3942,14 @@ class API:
         :param resources: A comma-separated list of resource families you want
                           to know the current rate limit disposition for.
 
-        :rtype: :class:`JSON` object
+        Returns
+        -------
+        :class:`dict`
+            JSON
 
-        :reference: https://developer.twitter.com/en/docs/twitter-api/v1/developer-utilities/rate-limit-status/api-reference/get-application-rate_limit_status
+        References
+        ----------
+        https://developer.twitter.com/en/docs/twitter-api/v1/developer-utilities/rate-limit-status/api-reference/get-application-rate_limit_status
         """
         return self.request(
             'GET', 'application/rate_limit_status', endpoint_parameters=(