Add FAQ section on inconsistency for high traffic / volume accounts

diff --git a/docs/faq.rst b/docs/faq.rst
index f50e4541311ca890a90d7efc08f7c8e35dc67e37..ca107154ab9941f0ae7801dbf51d96dc2c365b90 100644 (file)
--- a/docs/faq.rst
+++ b/docs/faq.rst
@@ -36,6 +36,16 @@ See `Twitter's API documentation on media best practices`_ for more information.
 
 .. _Twitter's API documentation on media best practices: https://developer.twitter.com/en/docs/twitter-api/v1/media/upload-media/uploading-media/media-best-practices
 
+Why am I getting an inconsistent number of / not getting 3200 Tweets for a specific user?
+-----------------------------------------------------------------------------------------
+
+    "For very high volume and high traffic accounts, be aware that the Twitter
+    API is highly distributed and eventually consistent. We strive to provide
+    current information but like any large scale system, you may see unexpected
+    behaviours at high volumes."
+
+https://twittercommunity.com/t/inconsistent-tweet-retrieval/150635
+
 Why am I getting no results from :meth:`API.search_tweets`?
 -----------------------------------------------------------