document 'extractor.twitter.expand' (#2848)

docs/configuration.rst

@@ -1551,7 +1551,7 @@ Description
 
 
 extractor.kemonoparty.favorites
----------------------------
+-------------------------------
 Type
     ``string``
 Default
@@ -2350,8 +2350,11 @@ Type
 Default
     ``false``
 Description
-    Fetch media from all Tweets and replies in a `conversation
+    For input URLs pointing to a single Tweet,
-    <https://help.twitter.com/en/using-twitter/twitter-conversations>`__.
+    e.g. `https://twitter.com/i/web/status/<TweetID>`,
+    fetch media from all Tweets and replies in this `conversation
+    <https://help.twitter.com/en/using-twitter/twitter-conversations>`__
+    or thread.
 
 
 extractor.twitter.csrf
@@ -2367,6 +2370,24 @@ Description
     * ``"cookies"``: Use token given by the ``ct0`` cookie if present.
 
 
+extractor.twitter.expand
+------------------------
+Type
+    ``bool``
+Default
+    ``false``
+Description
+    For each Tweet, return *all* Tweets from that initial Tweet's
+    conversation or thread, i.e. *expand* all Twitter threads.
+
+    Going through a timeline with this option enabled is essentially the same
+    as running ``gallery-dl https://twitter.com/i/web/status/<TweetID>``
+    with enabled `conversations <extractor.twitter.conversations_>`__ option
+    for each Tweet in said timeline.
+
+    Note: This requires at least 1 additional API call per initial Tweet.
+
+
 extractor.twitter.size
 ----------------------
 Type