Check-list for PRs

• Added .. versionadded:: NEXT.VERSION, .. versionchanged:: NEXT.VERSION, .. deprecated:: NEXT.VERSION or ``.. versionremoved:: NEXT.VERSION` to the docstrings for user facing changes (for methods/class descriptions, arguments and attributes)
• Created new or adapted existing unit tests
• Documented code changes according to the CSI standard
• Added new classes & modules to the docs and all suitable __all__ s
• Checked the Stability Policy in case of deprecations or changes to documented behavior

If the PR contains API changes (otherwise, you can ignore this passage)

• Checked the Bot API specific sections of the Stability Policy

• Created a PR to remove functionality deprecated in the previous Bot API release (see here)

• New Classes

  • Added self._id_attrs and corresponding documentation
  • __init__ accepts api_kwargs as keyword-only

• Added New Shortcuts

  • In telegram.Chat & telegram.User for all methods that accept chat/user_id
  • In telegram.Message for all methods that accept chat_id and message_id
  • For new telegram.Message shortcuts: Added quote argument if methods accept reply_to_message_id
  • In telegram.CallbackQuery for all methods that accept either chat_id and message_id or inline_message_id

• If Relevant

  • Added new constants at telegram.constants and shortcuts to them as class variables
  • Linked new and existing constants in docstrings instead of hard-coded numbers and strings
  • Added new message types to telegram.Message.effective_attachment
  • Added or updated documentation for the changed class(es) and/or method(s)

API 9.2 Items

• Added the class SuggestedPostDeclined and the field suggested_post_declined to the class Message, describing a service message about the rejection of a suggested post.
• Added the class SuggestedPostPaid and the field suggested_post_paid to the class Message, describing a service message about a successful payment for a suggested post.
• Added the class SuggestedPostRefunded and the field suggested_post_refunded to the class Message, describing a service message about a payment refund for a suggested post.