From: Harmon <Harmon758@gmail.com>
Date: Mon, 24 May 2021 13:04:40 +0000 (-0500)
Subject: Update and improve documentation for API.create_list
X-Git-Url: https://vcs.fsf.org/?a=commitdiff_plain;h=3f8003335a30a54e2d673ebf68f9d96ce39c638d;p=tweepy.git

Update and improve documentation for API.create_list
---

diff --git a/tweepy/api.py b/tweepy/api.py
index 80b4277..39cae26 100644
--- a/tweepy/api.py
+++ b/tweepy/api.py
@@ -1691,13 +1691,22 @@ class API:
         Creates a new list for the authenticated user.
         Note that you can create up to 1000 lists per account.
 
-        :param name: The name of the new list.
-        :param mode: |list_mode|
-        :param description: The description of the list you are creating.
+        Parameters
+        ----------
+        name
+            The name of the new list.
+        mode
+            |list_mode|
+        description
+            The description of the list you are creating.
 
-        :rtype: :class:`List` object
+        Returns
+        -------
+        :class:`~tweepy.models.List`
 
-        :reference: https://developer.twitter.com/en/docs/twitter-api/v1/accounts-and-users/create-manage-lists/api-reference/post-lists-create
+        References
+        ----------
+        https://developer.twitter.com/en/docs/twitter-api/v1/accounts-and-users/create-manage-lists/api-reference/post-lists-create
         """
         return self.request(
             'POST', 'lists/create', endpoint_parameters=(