Improve headings in Expansions and Fields documentation
authorHarmon <Harmon758@gmail.com>
Sat, 18 Mar 2023 11:37:10 +0000 (06:37 -0500)
committerHarmon <Harmon758@gmail.com>
Sat, 18 Mar 2023 11:37:10 +0000 (06:37 -0500)
docs/expansions_and_fields.rst

index 76b0fcab0ed29fea5e4f48799d306c83aa39d8c5..dcec83633eb7b7b8b27dace2183c22bc2e27e33e 100644 (file)
@@ -1,12 +1,13 @@
 .. _expansions_and_fields:
 
+*********************
 Expansions and Fields
-=====================
+*********************
 
 .. _expansions_parameter:
 
-``expansions``
---------------
+``expansions`` Parameter
+========================
 `Expansions`_ enable you to request additional data objects that relate to the
 originally returned List, Space, Tweets, Users, or Direct Message conversation
 events. Submit a list of desired expansions in a comma-separated list without
@@ -17,7 +18,7 @@ object, and will also include the ID so that you can match this data object to
 the original Space, Tweet, User or Direct Message conversation event object.
 
 Available expansions for Tweet payloads
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+---------------------------------------
 
 For methods that return Tweets, the following data objects can be expanded
 using this parameter:
@@ -58,7 +59,7 @@ using this parameter:
     +------------------------------------+-----------------------------------------------------------------------------------------------------+
 
 Available expansion for User payloads
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+-------------------------------------
 
 At this time, the only expansion available to endpoints that primarily return
 user objects is ``expansions=pinned_tweet_id``. You will find the expanded
@@ -74,7 +75,7 @@ Tweet data object living in the ``includes`` response object.
     +---------------------+---------------------------------------------------------------------------------------+
 
 Available expansions for Direct Message event payloads
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+------------------------------------------------------
 
 For methods that returns Direct Message conversation events, the following data
 objects can be expanded using this parameter:
@@ -100,7 +101,7 @@ objects can be expanded using this parameter:
     +----------------------------+------------------------------------------------------------------------------------------------------------------------+
 
 Available expansions for Spaces payloads
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+----------------------------------------
 
 For methods that return Spaces, the following data objects can be expanded
 using this parameter:
@@ -128,7 +129,7 @@ using this parameter:
     +----------------------+----------------------------------------------------------------------+
 
 Available expansion for Lists payloads
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+--------------------------------------
 
 At this time, the only expansion available to endpoints that primarily return
 List objects is ``expansions=owner_id``. You will find the expanded user data
@@ -144,9 +145,12 @@ object living in the ``includes`` response object.
     +--------------+--------------------------------------------------------------------------------+
 
 References
-^^^^^^^^^^
+----------
 https://developer.twitter.com/en/docs/twitter-api/expansions
 
+`Fields`_ Parameters
+====================
+
 .. _dm_event_fields_parameter:
 
 ``dm_event_fields``
@@ -271,7 +275,7 @@ user data objects.
 .. _user fields: https://developer.twitter.com/en/docs/twitter-api/data-dictionary/object-model/user
 
 Constants
----------
+=========
 
 These constants are available directly in the :mod:`tweepy` module, which means
 each file itself does not need to be imported. For example,