Update and improve documentation for API.simple_upload

diff --git a/tweepy/api.py b/tweepy/api.py
index cd59e3bb8a135ac7633799ce8a0a1fe5b9180f73..ebfee161c4012f13f9b3ed7bc9b9cd3cb410b005 100644 (file)
--- a/tweepy/api.py
+++ b/tweepy/api.py
@@ -3411,14 +3411,24 @@ class API:
         Use this endpoint to upload media to Twitter. This does not use the
         chunked upload endpoints.
 
-        :param filename: |filename|
-        :param file: |file|
-        :param media_category: |media_category|
-        :param additional_owners: |additional_owners|
+        Parameters
+        ----------
+        filename
+            |filename|
+        file
+            |file|
+        media_category
+            |media_category|
+        additional_owners
+            |additional_owners|
 
-        :rtype: :class:`Media` object
+        Returns
+        -------
+        :class:`~tweepy.models.Media`
 
-        :reference: https://developer.twitter.com/en/docs/twitter-api/v1/media/upload-media/api-reference/post-media-upload
+        References
+        ----------
+        https://developer.twitter.com/en/docs/twitter-api/v1/media/upload-media/api-reference/post-media-upload
         """
         with contextlib.ExitStack() as stack:
             if file is not None: