Add references to wiki

telegram/_bot.py

@@ -145,9 +145,7 @@ class Bot(TelegramObject, AbstractAsyncContextManager):
         :attr:`telegram.ext.Updater.bot`,
         `Builder Pattern <https://github.com/\
         python-telegram-bot/python-telegram-bot/wiki/Builder-Pattern>`_,
-        `Making Your Bot Persistent <https://github.com/\
-        python-telegram-bot/python-telegram-bot/wiki/Making-your-bot-persistent>`_
-
+        :any:`Raw API Bot Example <examples.rawapibot>`
 
     .. versionadded:: 13.2
         Objects of this class are comparable in terms of equality. Two objects of this class are
@@ -3534,6 +3532,8 @@ async def set_webhook(
             If you're having any trouble setting up webhooks, please check out this `guide to
             Webhooks`_.
 
+        .. seealso:: :any:`Custom Webhook Bot Example <examples.customwebhookbot>`
+
         Args:
             url (:obj:`str`): HTTPS url to send updates to. Use an empty string to remove webhook
                 integration.

telegram/_chat.py

@@ -65,6 +65,8 @@ class Chat(TelegramObject):
     Objects of this class are comparable in terms of equality. Two objects of this class are
     considered equal, if their :attr:`id` is equal.
 
+    .. seealso:: :any:`Chat Member Bot Example <examples.chatmemberbot>`
+
     .. versionchanged:: 20.0
 
         * Removed the deprecated methods ``kick_member`` and ``get_members_count``.

telegram/_chatmember.py

@@ -44,7 +44,7 @@ class ChatMember(TelegramObject):
     Objects of this class are comparable in terms of equality. Two objects of this class are
     considered equal, if their :attr:`user` and :attr:`status` are equal.
 
-    .. seealso:: :any:`Chat Member Example <examples.chatmemberbot>`
+    .. seealso:: :any:`Chat Member Bot Example <examples.chatmemberbot>`
 
     .. versionchanged:: 20.0
 

telegram/_chatmemberupdated.py

@@ -44,6 +44,8 @@ class ChatMemberUpdated(TelegramObject):
     Note:
         In Python :keyword:`from` is a reserved word use :paramref:`from_user` instead.
 
+    .. seealso:: :any:`Chat Member Bot Example <examples.chatmemberbot>`
+
     Args:
         chat (:class:`telegram.Chat`): Chat the user belongs to.
         from_user (:class:`telegram.User`): Performer of the action, which resulted in the change.

telegram/_inline/inlinequeryresult.py

@@ -33,6 +33,8 @@ class InlineQueryResult(TelegramObject):
         All URLs passed in inline query results will be available to end users and therefore must
         be assumed to be *public*.
 
+    .. seealso:: :any:`Inline Bot Example <examples.inlinebot>`
+
     Args:
         type (:obj:`str`): Type of the result.
         id (:obj:`str`): Unique identifier for this result, 1-64 Bytes.

telegram/_message.py

@@ -103,8 +103,6 @@ class Message(TelegramObject):
         from_user (:class:`telegram.User`, optional): Sender of the message; empty for messages
             sent to channels. For backward compatibility, this will contain a fake sender user in
             non-channel chats, if the message was sent on behalf of a chat.
-
-            .. seealso:: :any:`Conversationbot Example <examples.conversationbot>`
         sender_chat (:class:`telegram.Chat`, optional): Sender of the message, sent on behalf of a
             chat. For example, the channel itself for channel posts, the supergroup itself for
             messages from anonymous group administrators, the linked channel for messages
@@ -254,8 +252,6 @@ class Message(TelegramObject):
         from_user (:class:`telegram.User`): Optional. Sender of the message; empty for messages
             sent to channels. For backward compatibility, this will contain a fake sender user in
             non-channel chats, if the message was sent on behalf of a chat.
-
-            .. seealso:: :any:`Conversationbot Example <examples.conversationbot>`
         sender_chat (:class:`telegram.Chat`): Optional. Sender of the message, sent on behalf of a
             chat. For example, the channel itself for channel posts, the supergroup itself for
             messages from anonymous group administrators, the linked channel for messages
@@ -369,6 +365,8 @@ class Message(TelegramObject):
         author_signature (:obj:`str`): Optional. Signature of the post author for messages in
             channels, or the custom title of an anonymous group administrator.
         passport_data (:class:`telegram.PassportData`): Optional. Telegram Passport data.
+
+            .. seealso:: :any:`Passport Bot Example <examples.passportbot>`
         poll (:class:`telegram.Poll`): Optional. Message is a native poll,
             information about the poll.
         dice (:class:`telegram.Dice`): Optional. Message is a dice with random value.
@@ -821,9 +819,6 @@ async def reply_text(
 
         For the documentation of the arguments, please see :meth:`telegram.Bot.send_message`.
 
-        .. seealso:: :any:`Conversationbot Example <examples.conversationbot>`,
-        :any:`Conversationbot Example 2 <examples.conversationbot2>`
-
         Keyword Args:
             quote (:obj:`bool`, optional): If set to :obj:`True`, the message is sent as an actual
                 reply to this message. If ``reply_to_message_id`` is passed, this parameter will be

telegram/_update.py

@@ -107,6 +107,9 @@ class Update(TelegramObject):
         chosen_inline_result (:class:`telegram.ChosenInlineResult`): Optional. The result of an
             inline query that was chosen by a user.
         callback_query (:class:`telegram.CallbackQuery`): Optional. New incoming callback query.
+
+            .. seealso:: :any:`Arbitrary Callback Data Bot Example
+                <examples.arbitrarycallbackdatabot>`
         shipping_query (:class:`telegram.ShippingQuery`): Optional. New incoming shipping query.
         pre_checkout_query (:class:`telegram.PreCheckoutQuery`): Optional. New incoming
             pre-checkout query.

telegram/error.py

@@ -89,6 +89,8 @@ def __reduce__(self) -> Tuple[type, Tuple[str]]:
 class Forbidden(TelegramError):
     """Raised when the bot has not enough rights to perform the requested action.
 
+    .. seealso:: :any:`Raw API Bot Example <examples.rawapibot>`
+
     .. versionchanged:: 20.0
         This class was previously named ``Unauthorized``.
     """
@@ -112,7 +114,10 @@ def __init__(self, message: str = None) -> None:
 
 
 class NetworkError(TelegramError):
-    """Base class for exceptions due to networking errors."""
+    """Base class for exceptions due to networking errors.
+
+    .. seealso:: :any:`Raw API Bot Example <examples.rawapibot>`
+    """
 
     __slots__ = ()
 

telegram/ext/_application.py

@@ -604,10 +604,7 @@ def run_polling(
         .. seealso::
             :meth:`initialize`, :meth:`start`, :meth:`stop`, :meth:`shutdown`
             :meth:`telegram.ext.Updater.start_polling`, :meth:`telegram.ext.Updater.stop`,
-            :meth:`run_webhook`,
-            `Your First Bot <https://github.com/\
-            python-telegram-bot/python-telegram-bot/wiki/Extensions-–-Your-first-Bot>`_,
-            :any:`Echobot Example <examples.echobot>`
+            :meth:`run_webhook`
 
         Args:
             poll_interval (:obj:`float`, optional): Time to wait between polling updates from
@@ -1078,13 +1075,7 @@ def add_handler(self, handler: BaseHandler[Any, CCT], group: int = DEFAULT_GROUP
         .. seealso:: `Your First Bot <https://github.com/\
             python-telegram-bot/python-telegram-bot/wiki/Extensions-–-Your-first-Bot>`_,
             `Architecture Overview <https://github.com/\
-            python-telegram-bot/python-telegram-bot/wiki/Architecture>`_,
-            `Builder Pattern <https://github.com/\
-            python-telegram-bot/python-telegram-bot/wiki/Builder-Pattern>`_,
-            `Storing Bot, User and Chat Related Data <https://github.com/\
-            python-telegram-bot/python-telegram-bot/wiki/Storing-bot%2C-user-and-\
-            chat-related-data>`_,
-            :any:`Echobot Example <examples.echobot>`
+            python-telegram-bot/python-telegram-bot/wiki/Architecture>`_
 
         Args:
             handler (:class:`telegram.ext.BaseHandler`): A BaseHandler instance.

telegram/ext/_callbackcontext.py

@@ -67,10 +67,10 @@ class CallbackContext(Generic[BT, UD, CD, BD]):
     4. The type of :attr:`bot_data` (if :attr:`bot_data` is not :obj:`None`).
 
     .. seealso:: :attr:`telegram.ext.ContextTypes.DEFAULT_TYPE`,
-        `Your First Bot <https://github.com/\
-        python-telegram-bot/python-telegram-bot/wiki/Extensions-–-Your-first-Bot>`_,
         `Job Queue <https://github.com/python-telegram-bot/
-        python-telegram-bot/wiki/Extensions-%E2%80%93-JobQueue>`_
+        python-telegram-bot/wiki/Extensions-%E2%80%93-JobQueue>`_,
+        :any:`Context Types Bot Example <examples.contexttypesbot>`,
+        :any:`Custom Webhook Bot Example <examples.customwebhookbot>`
 
     Args:
         application (:class:`telegram.ext.Application`): The application associated with this
@@ -95,9 +95,6 @@ class CallbackContext(Generic[BT, UD, CD, BD]):
             is handled by :class:`telegram.ext.CommandHandler`, :class:`telegram.ext.PrefixHandler`
             or :class:`telegram.ext.StringCommandHandler`. It contains a list of the words in the
             text after the command, using any whitespace string as a delimiter.
-
-            .. seealso:: `Your First Bot <https://github.com/\
-            python-telegram-bot/python-telegram-bot/wiki/Extensions-–-Your-first-Bot>`_
         error (:exc:`Exception`): Optional. The error that was raised. Only present when passed
             to an error handler registered with :attr:`telegram.ext.Application.add_error_handler`.
         job (:class:`telegram.ext.Job`): Optional. The job which originated this callback.

telegram/ext/_callbackdatacache.py

@@ -39,7 +39,8 @@ class InvalidCallbackData(TelegramError):
     Raised when the received callback data has been tempered with or deleted from cache.
 
     .. seealso:: `Arbitrary callback_data <https://github.com/\
-            python-telegram-bot/python-telegram-bot/wiki/Arbitrary-callback_data>`_
+            python-telegram-bot/python-telegram-bot/wiki/Arbitrary-callback_data>`_,
+            :any:`Arbitrary Callback Data Bot Example <examples.arbitrarycallbackdatabot>`
 
     .. versionadded:: 13.6
 

telegram/ext/_callbackqueryhandler.py

@@ -55,8 +55,8 @@ class CallbackQueryHandler(BaseHandler[Update, CCT]):
         When setting :paramref:`block` to :obj:`False`, you cannot rely on adding custom
         attributes to :class:`telegram.ext.CallbackContext`. See its docs for more info.
 
-    .. seealso:: `Types of Handlers <https://github.com/\
-        python-telegram-bot/python-telegram-bot/wiki/Types-of-Handlers>`_,
+    .. seealso:: :any:`Nested Conversation Bot Example <examples.nestedconversationbot>`,
+        :any:`Arbitrary Callback Data Bot Example <examples.arbitrarycallbackdatabot>`
 
     Args:
         callback (:term:`coroutine function`): The callback function for this handler. Will be
@@ -93,6 +93,9 @@ async def callback(update: Update, context: CallbackContext)
             be awaited before processing the next handler in
             :meth:`telegram.ext.Application.process_update`. Defaults to :obj:`True`.
 
+            .. seealso:: `Concurrency <https://github.com/\
+                python-telegram-bot/python-telegram-bot/wiki/Concurrency>`_
+
     Attributes:
         callback (:term:`coroutine function`): The callback function for this handler.
         pattern (:func:`re.Pattern <re.compile>` | :obj:`callable` | :obj:`type`): Optional.

telegram/ext/_chatjoinrequesthandler.py

@@ -66,6 +66,9 @@ async def callback(update: Update, context: CallbackContext)
             be awaited before processing the next handler in
             :meth:`telegram.ext.Application.process_update`. Defaults to :obj:`True`.
 
+            .. seealso:: `Concurrency <https://github.com/\
+                python-telegram-bot/python-telegram-bot/wiki/Concurrency>`_
+
     Attributes:
         callback (:term:`coroutine function`): The callback function for this handler.
         block (:obj:`bool`): Determines whether the callback will run in a blocking way..

telegram/ext/_chatmemberhandler.py

@@ -35,7 +35,7 @@ class ChatMemberHandler(BaseHandler[Update, CCT]):
         When setting :paramref:`block` to :obj:`False`, you cannot rely on adding custom
         attributes to :class:`telegram.ext.CallbackContext`. See its docs for more info.
 
-    .. seealso:: :any:`Chat Member Example <examples.chatmemberbot>`
+    .. seealso:: :any:`Chat Member Bot Example <examples.chatmemberbot>`
 
     .. versionadded:: 13.4
 
@@ -56,6 +56,9 @@ async def callback(update: Update, context: CallbackContext)
             be awaited before processing the next handler in
             :meth:`telegram.ext.Application.process_update`. Defaults to :obj:`True`.
 
+            .. seealso:: `Concurrency <https://github.com/\
+                python-telegram-bot/python-telegram-bot/wiki/Concurrency>`_
+
     Attributes:
         callback (:term:`coroutine function`): The callback function for this handler.
         chat_member_types (:obj:`int`, optional): Specifies if this handler should handle

telegram/ext/_choseninlineresulthandler.py

@@ -52,6 +52,9 @@ async def callback(update: Update, context: CallbackContext)
         block (:obj:`bool`, optional): Determines whether the return value of the callback should
             be awaited before processing the next handler in
             :meth:`telegram.ext.Application.process_update`. Defaults to :obj:`True`.
+
+            .. seealso:: `Concurrency <https://github.com/\
+                python-telegram-bot/python-telegram-bot/wiki/Concurrency>`_
         pattern (:obj:`str` | :func:`re.Pattern <re.compile>`, optional): Regex pattern. If not
             :obj:`None`, :func:`re.match`
             is used on :attr:`telegram.ChosenInlineResult.result_id` to determine if an update

telegram/ext/_commandhandler.py

@@ -57,10 +57,8 @@ class CommandHandler(BaseHandler[Update, CCT]):
         When setting :paramref:`block` to :obj:`False`, you cannot rely on adding custom
         attributes to :class:`telegram.ext.CallbackContext`. See its docs for more info.
 
-    .. seealso:: `Your First Bot <https://github.com/\
-        python-telegram-bot/python-telegram-bot/wiki/Extensions-–-Your-first-Bot>`_,
-        `Types of Handlers <https://github.com/\
-        python-telegram-bot/python-telegram-bot/wiki/Types-of-Handlers>`_
+    .. seealso:: :any:`Timer Bot Example <examples.timerbot>`,
+        :any:`Error Handler Bot Example <examples.errorhandlerbot>`
 
     .. versionchanged:: 20.0
 
@@ -88,6 +86,9 @@ async def callback(update: Update, context: CallbackContext)
             be awaited before processing the next handler in
             :meth:`telegram.ext.Application.process_update`. Defaults to :obj:`True`.
 
+            .. seealso:: `Concurrency <https://github.com/\
+                python-telegram-bot/python-telegram-bot/wiki/Concurrency>`_
+
     Raises:
         :exc:`ValueError`: When the command is too long or has illegal chars.
 

telegram/ext/_contexttypes.py

@@ -37,8 +37,6 @@ class ContextTypes(Generic[CCT, UD, CD, BD]):
         python-telegram-bot/python-telegram-bot/wiki/Architecture>`_,
         `Storing Bot, User and Chat Related Data <https://github.com/\
         python-telegram-bot/python-telegram-bot/wiki/Storing-bot%2C-user-and-chat-related-data>`_,
-        `Job Queue <https://github.com/python-telegram-bot/
-        python-telegram-bot/wiki/Extensions-%E2%80%93-JobQueue>`_,
         :any:`ContextTypes Example <examples.contexttypesbot>`
 
     .. versionadded:: 13.6

telegram/ext/_conversationhandler.py

@@ -245,6 +245,9 @@ class ConversationHandler(BaseHandler[Update, CCT]):
             2. the value passed to this parameter (if any)
             3. :attr:`telegram.ext.Defaults.block` (if defaults are used)
 
+            .. seealso:: `Concurrency <https://github.com/\
+                python-telegram-bot/python-telegram-bot/wiki/Concurrency>`_
+
             .. versionchanged:: 20.0
                 No longer overrides the handlers settings. Resolution order was changed.
 

telegram/ext/_extbot.py

@@ -228,6 +228,9 @@ def callback_data_cache(self) -> Optional[CallbackDataCache]:
         """:class:`telegram.ext.CallbackDataCache`: Optional. The cache for
         objects passed as callback data for :class:`telegram.InlineKeyboardButton`.
 
+        .. seealso:: :any:`Arbitrary Callback Data Bot Example
+            <examples.arbitrarycallbackdatabot>`
+
         .. versionchanged:: 20.0
            * This property is now read-only.
            * This property is now optional and can be :obj:`None` if

telegram/ext/_handler.py

@@ -54,9 +54,7 @@ class BaseHandler(Generic[UT, CCT], ABC):
            also used for the mentioned method arguments. That way, a type checker can check whether
            this handler fits the definition of the :class:`~Application`.
 
-    .. seealso:: `Your First Bot <https://github.com/\
-        python-telegram-bot/python-telegram-bot/wiki/Extensions-–-Your-first-Bot>`_,
-        `Types of Handlers <https://github.com/\
+    .. seealso:: `Types of Handlers <https://github.com/\
         python-telegram-bot/python-telegram-bot/wiki/Types-of-Handlers>`_
 
     .. versionchanged:: 20.0

telegram/ext/_inlinequeryhandler.py

@@ -47,8 +47,6 @@ class InlineQueryHandler(BaseHandler[Update, CCT]):
           updates won't be handled, if :attr:`chat_types` is passed.
 
     .. seealso:: :any:`Inlinebot Example <examples.inlinebot>`,
-        `Your First Bot <https://github.com/\
-        python-telegram-bot/python-telegram-bot/wiki/Extensions-–-Your-first-Bot>`_,
         `Types of Handlers <https://github.com/\
         python-telegram-bot/python-telegram-bot/wiki/Types-of-Handlers>`_
 
@@ -68,6 +66,9 @@ async def callback(update: Update, context: CallbackContext)
         block (:obj:`bool`, optional): Determines whether the return value of the callback should
             be awaited before processing the next handler in
             :meth:`telegram.ext.Application.process_update`. Defaults to :obj:`True`.
+
+            .. seealso:: `Concurrency <https://github.com/\
+                python-telegram-bot/python-telegram-bot/wiki/Concurrency>`_
         chat_types (List[:obj:`str`], optional): List of allowed chat types. If passed, will only
             handle inline queries with the appropriate :attr:`telegram.InlineQuery.chat_type`.
 

telegram/ext/_messagehandler.py

@@ -40,11 +40,7 @@ class MessageHandler(BaseHandler[Update, CCT]):
         When setting :paramref:`block` to :obj:`False`, you cannot rely on adding custom
         attributes to :class:`telegram.ext.CallbackContext`. See its docs for more info.
 
-    .. seealso:: `Your First Bot <https://github.com/\
-        python-telegram-bot/python-telegram-bot/wiki/Extensions-–-Your-first-Bot>`_,
-        `Types of Handlers <https://github.com/\
-        python-telegram-bot/python-telegram-bot/wiki/Types-of-Handlers>`_,
-        `Advanced Filters <https://github.com/\
+    .. seealso:: `Advanced Filters <https://github.com/\
         python-telegram-bot/python-telegram-bot/wiki/Extensions-–-Advanced-Filters>`_
 
     Args:
@@ -68,6 +64,9 @@ async def callback(update: Update, context: CallbackContext)
             be awaited before processing the next handler in
             :meth:`telegram.ext.Application.process_update`. Defaults to :obj:`True`.
 
+            .. seealso:: `Concurrency <https://github.com/\
+                python-telegram-bot/python-telegram-bot/wiki/Concurrency>`_
+
     Attributes:
         filters (:class:`telegram.ext.filters.BaseFilter`): Only allow updates with these Filters.
             See :mod:`telegram.ext.filters` for a full list of all available filters.

telegram/ext/_picklepersistence.py

@@ -131,7 +131,8 @@ class PicklePersistence(BasePersistence[UD, CD, BD]):
         :attr:`~BasePersistence.bot` will be inserted back when loading the data.
 
     .. seealso:: `Making Your Bot Persistent <https://github.com/\
-        python-telegram-bot/python-telegram-bot/wiki/Making-your-bot-persistent>`_
+        python-telegram-bot/python-telegram-bot/wiki/Making-your-bot-persistent>`_,
+        :any:`Persistent Conversation Bot Example <examples.persistentconversationbot>`
 
     .. versionchanged:: 20.0