From 360594b9044a4b75c9cb1d0e47462e155ef75c12 Mon Sep 17 00:00:00 2001
From: Harmon <Harmon758@gmail.com>
Date: Sun, 27 Feb 2022 13:25:18 -0600
Subject: [PATCH] Add documentation for List

---
 docs/v2_models.rst |  9 +++++----
 tweepy/list.py     | 42 ++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 47 insertions(+), 4 deletions(-)

diff --git a/docs/v2_models.rst b/docs/v2_models.rst
index 0923791..93cd0cd 100644
--- a/docs/v2_models.rst
+++ b/docs/v2_models.rst
@@ -1,16 +1,17 @@
 .. _v2_models_reference:
 
+.. currentmodule:: tweepy
+
 ******
 Models
 ******
 
 .. versionadded:: 4.0
 
-.. class:: tweepy.List
-
-   .. versionadded:: 4.4
+:class:`List`
+=============
 
-   :reference: https://developer.twitter.com/en/docs/twitter-api/data-dictionary/object-model/lists
+.. autoclass:: List()
 
 .. class:: tweepy.Media
 
diff --git a/tweepy/list.py b/tweepy/list.py
index 3c36ed5..b2a5044 100644
--- a/tweepy/list.py
+++ b/tweepy/list.py
@@ -7,6 +7,48 @@ from tweepy.utils import parse_datetime
 
 
 class List(HashableID, DataMapping):
+    """The list object contains `Twitter Lists`_ metadata describing the
+    referenced List. The List object is the primary object returned in the List
+    lookup endpoint. When requesting additional List fields on this endpoint,
+    simply use the fields parameter ``list.fields``.
+
+    At the moment, the List object cannot be found as a child object from any
+    other data object. However, user objects can be found and expanded in the
+    user resource. These objects are available for expansion by adding
+    ``owner_id`` to the ``expansions`` query parameter. Use the expansion with
+    the field parameter: ``list.fields`` when requesting additional fields to
+    complete the primary List object and ``user.fields`` to complete the
+    expansion object.
+
+    .. versionadded:: 4.4
+
+    Attributes
+    ----------
+    data : dict
+        The JSON data representing the List.
+    id : str
+        The unique identifier of this List.
+    name : str
+        The name of the List, as defined when creating the List.
+    created_at : datetime.datetime | None
+        The UTC datetime that the List was created on Twitter.
+    description : str | None
+        A brief description to let users know about the List.
+    follower_count : int | None
+        Shows how many users follow this List,
+    member_count : int | None
+        Shows how many members are part of this List.
+    private : bool | None
+        Indicates if the List is private.
+    owner_id : str | None
+        Unique identifier of this List's owner.
+
+    References
+    ----------
+    https://developer.twitter.com/en/docs/twitter-api/data-dictionary/object-model/lists
+
+    .. _Twitter Lists: https://help.twitter.com/en/using-twitter/twitter-lists
+    """
 
     __slots__ = (
         "data", "id", "name", "created_at", "description", "follower_count",
-- 
2.25.1