Add documentation for Direct Message events

This documentation was previously missing from the Twitter API documentation when the Twitter API v2 Direct Messages endpoints were launched but has now recently been added.

Merge pull request #2009 from qin-yu/qy/dm-event-doc

Add fields documentation for Direct Message events

Remove DM event section in docs/expansions_and_fields.rst

The documentation for dm_event.fields is different and there are no endpoints with that parameter that return other types of objects, so this section is unnecessary.

@Harmon758 have plans to improve this documentation as a whole to include documentation from https://developer.twitter.com/en/docs/twitter-api/expansions, so for now, for consistency, this section shouldn't be here.

But if we want some completeness in this doc page before the next big doc improvement (and also for the consistency in Client methods' docstrings), we can put the following code back later just in case people thought the doc is not up-to-date:

```rst
.. _dm_event_fields_parameter:

``dm_event_fields``
---------------

Extra fields to include in the event payload. `id`, `text` and `event_type` are
returned by default.

.. _Direct Message event fields: https://developer.twitter.com/en/docs/twitter-api/data-dictionary/object-model/dm-events
```

Co-Authored-By: Harmon <Harmon.Public@gmail.com>

Update Direct Message events' expansions in docs/expansions_and_fields.rst

For consistency, this section should also be taken from the description for the expansions parameter for endpoints that return the object type, e.g. https://developer.twitter.com/en/docs/twitter-api/direct-messages/lookup/api-reference/get-dm_conversations-with-participant_id-dm_events for DM events.

Future work: improve this section of the documentation in the future to include information like this from https://developer.twitter.com/en/docs/twitter-api/expansions

Co-authored-by: Harmon <Harmon758@gmail.com>

Update expansions section in docs/expansions_and_fields.rst

The term "___ object" is used in a natural language context, and Twitter's official documents do use lower cases for "user" and "event". Also, indeed, query parameters' descriptions in all three Direct Messages lookup API references ([1](https://developer.twitter.com/en/docs/twitter-api/direct-messages/lookup/api-reference/get-dm_events) [2](https://developer.twitter.com/en/docs/twitter-api/direct-messages/lookup/api-reference/get-dm_conversations-with-participant_id-dm_events) [3](https://developer.twitter.com/en/docs/twitter-api/direct-messages/lookup/api-reference/get-dm_conversations-dm_conversation_id-dm_events)) use the term "Direct Message conversation event", though in the informal abstract/intro sections they use "Direct Messages (DM) events", "Direct Messages" and "Messages" interchangeably.

Co-authored-by: Harmon <Harmon758@gmail.com>

Add fields documentation for Direct Message events

Move SECURITY.md to .github folder

Create SECURITY.md

Add DOI for v4.12.1 to CITATION

Release v4.12.1

Add changelog for version 4.12.1

Change initial network_error_wait to 0 for streaming

Attempt to reconnect immediately when established streaming connection drops

Document limit and pagination_token parameters for AsyncPaginator

Document limit and pagination_token parameters for Paginator

Fix Intersphinx link to namedtuple in documentation for Response

Warn when Tweet data is missing default edit_history_tweet_ids field

Add CITATION.cff

Improve format of badges in README

Add DOI badge to README

Log streaming connection error exceptions

Default AsyncBaseStream to abort closed SSL transports

Resolves #1904

Add 1 second buffer to API v2 streaming timeout

The keep-alive is often received after marginally longer than 20 seconds, causing unnecessary timeouts and reconnects with a timeout of exactly 20 seconds

Replace docs/requirements.txt with docs extra

Use _construct_response in AsyncClient._make_request

Merge pull request #1997 from JEnduriumK/master

Breakout Response creation into separate method

Breakout Response creation into separate method

Release v4.12.0

Add changelog for version 4.12.0

Add support for Twitter API v2 Direct Messages endpoints

Resolves #1995

Add missing angle bracket to string representation of ReferencedTweet

Fix signature of Client.get_quote_tweets in documentation

Revert "Change API method docstrings to raw strings"

This reverts commit fb851a0192cb97d321611eb33427b872ff5ccbb9.

This broke multi-line signature overrides and will likely be resolved with type hints anyway.

Improve exceptions raised for unknown method return types for pagination

Handle different method return types in flatten methods for pagination

Add version changed directive to documentation for Media

Merge pull request #1910 from New-dev0/patch-1

Add missing "variants" to Media Object

Update tweepy/media.py

Co-authored-by: Harmon <Harmon758@gmail.com>

Add documentation for Tweet fields

edit_history_tweet_ids and edit_controls

Fix class references in notes in documentation for AsyncClient methods

Update actions/setup-python from v3 to v4

Update actions/setup-python from v2 to v3

Add support for Python 3.11

Change API method docstrings to raw strings

Prevent DeprecationWarnings about invalid escape sequences

Improve formatting in api.py

Merge pull request #1861 from lqhuang/fix-meta-attr-for-paginator

Fix `AttributeError` by accessing `meta` field when `return_type` is dict

Adjust line length for `AsyncPaginator` docstring

Adjust docstring for sync/async Paginator

Release v4.11.0

Add changelog for version 4.11.0

Add version changed directive to documentation for Tweet

Add version changed directive to documentation for API

Fix incorrect `Response` type for `AsyncPaginator` and revert formatting from `black`

Fix handling of `meta` attr for different response types

Fix `AttributeError` by accessing `meta` field when return_type is dict

Update changelog references in FAQ

Improve documentation for wait_on_rate_limit parameter for streaming

Resolves part of #1986

Lower API v2 streaming timeout to 20 seconds

Resolves part of #1986

Handle 429 HTTP errors for streaming

Resolves #1982
Resolves #1986

Normalize import order in asynchronous.__init__

Update models.List methods to use list ID instead of slug

Update models.List methods to pass keyword arguments to API methods

Resolves #1987

Add pagination for AsyncClient

Add version changed directive to documentation for get_quote_tweets

Update signature for get_quote_tweets in documentation

Add exclude parameter

Add version changed directive to documentation for get_list_tweets

Update signature for get_list_tweets in documentation

Add media_fields, place_fields, and poll_fields parameters

Fix changelog heading for version 4.0.1

Add sections for old and previously missing versions to changelog

Add release dates to changelog

Update cassettes for testing methods that return Tweet objects

Support edit_history_tweet_ids and edit_controls Tweet fields

Resolves #1979

Check oauth_client is not None in AsyncBaseStream._connect

Change AsyncBaseStream._connect oauth_1 parameter to oauth_client

Add oauth_1 parameter to AsyncBaseStream._connect for AsyncStream

This allows the Authorization header to be regenerated in AsyncBaseStream._connect prior to any reconnection requests, when used through AsyncStream._connect

Support include_ext_edit_control parameter for API methods

Use tuple for API.indicate_direct_message_typing endpoint_parameters

Log text of HTTP response when handling request error in AsyncBaseStream

Add support for exclude parameter for get_quote_tweets

This was previously undocumented for the endpoint:
https://twittercommunity.com/t/quote-tweets-api-can-use-exclude-parameter/171392

Release v4.10.1

Add changelog for version 4.10.1

Ignore AsyncClient method parameters explicitly passed as None

Resolves #1944

Add support for get_list_tweets parameters

Add support for media_fields, place_fields, and poll_fields parameters for get_list_tweets

Resolves #1931

Correct typo in documentation for add_rules and delete_rules

Resolves #1937

Fix handling of StreamRule in list passed to delete_rules

Resolves #1942

Add missing variant to Media Object

Log text of HTTP response when handling request error in BaseStream

Update Requests documentation URL for Intersphinx linking

https://github.com/psf/requests/issues/6140

Merge pull request #1902 from Myyyth/master

Fix request method non-awaitable after receiving rate limit (429)

Release v4.10.0

Add changelog for version 4.10.0

Fix request method non-awaitable after receiving rate limit (429)

Add Client.get_home_timeline and AsyncClient.get_home_timeline

Resolves #1900

Improve documentation for AsyncStream proxy parameter

Add Raises section to StreamingClient.sample documentation

Add Raises section to StreamingClient.filter documentation

Add Raises section to Stream.sample documentation

Improve Raises section of Stream.filter documentation

Add note about new Twitter Developer Apps in AsyncStream documentation

Add note about new Twitter Developer Apps in Stream documentation

Remove StreamRule.__init__ documentation