python-telegram-bot · harshil21 · Jul 27, 2026 · Aug 4, 2026 · Aug 4, 2026 · Aug 4, 2026
diff --git a/README.rst b/README.rst
@@ -182,7 +182,7 @@ Resources
 - The `package documentation <https://docs.python-telegram-bot.org/>`_ is the technical reference for ``python-telegram-bot``.
   It contains descriptions of all available classes, modules, methods and arguments as well as the `changelog <https://docs.python-telegram-bot.org/changelog.html>`_.
 - The `wiki <https://github.com/python-telegram-bot/python-telegram-bot/wiki/>`_ is home to number of more elaborate introductions of the different features of ``python-telegram-bot`` and other useful resources that go beyond the technical documentation.
-- Our `examples section <https://docs.python-telegram-bot.org/examples.html>`_ contains several examples that showcase the different features of both the Bot API and ``python-telegram-bot``.
+- Our `examples section <https://docs.python-telegram-bot.org/examples/index.html>`_ contains several examples that showcase the different features of both the Bot API and ``python-telegram-bot``.
   Even if it is not your approach for learning, please take a look at ``echobot.py``. It is the de facto base for most of the bots out there.
   The code for these examples is released to the public domain, so you can start by grabbing the code and building on top of it.
 - The `official Telegram Bot API documentation <https://core.telegram.org/bots/api>`_ is of course always worth a read.

diff --git a/docs/auxil/api_docs.py b/docs/auxil/api_docs.py
diff --git a/docs/source/_templates/ptb-object.rst b/docs/source/_templates/ptb-object.rst
@@ -0,0 +1,9 @@
+.. Autogenerated page: True
+
+{{ objname | escape | underline }}
+
+.. currentmodule:: {{ module }}
+
+.. auto{{ objtype }}:: {{ objname }}{% if objtype in ["class", "exception"] %}
+    :members:
+    :show-inheritance:{% endif %}
diff --git a/docs/source/conf.py b/docs/source/conf.py
@@ -43,6 +43,7 @@
 extensions = [
     "chango.sphinx_ext",
     "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
     "sphinx.ext.napoleon",
     "sphinx.ext.intersphinx",
     "sphinx.ext.linkcode",
@@ -51,6 +52,7 @@
     "sphinx_copybutton",
     "sphinx_inline_tabs",
     "sphinxcontrib.mermaid",
+    "docs.auxil.api_docs",
 ]
 
 # Temporary. See #4387
@@ -80,6 +82,9 @@
 # You can specify multiple suffix as a list of string:
 source_suffix = ".rst"
 
+# API fragments are included by generated dotted-name wrappers. Example pages are read in place.
+exclude_patterns = ["telegram/**", "telegram_auxil/**"]
+
 # The master toctree document.
 master_doc = "index"
 

diff --git a/docs/source/examples.chatmemberbot.rst b/docs/source/examples.chatmemberbot.rst
diff --git a/docs/source/examples.contexttypesbot.rst b/docs/source/examples.contexttypesbot.rst
diff --git a/docs/source/examples.deeplinking.rst b/docs/source/examples.deeplinking.rst
diff --git a/docs/source/examples.echobot.rst b/docs/source/examples.echobot.rst
diff --git a/docs/source/examples.errorhandlerbot.rst b/docs/source/examples.errorhandlerbot.rst
diff --git a/docs/source/examples.inlinebot.rst b/docs/source/examples.inlinebot.rst
diff --git a/docs/source/examples.inlinekeyboard.rst b/docs/source/examples.inlinekeyboard.rst
diff --git a/docs/source/examples.inlinekeyboard2.rst b/docs/source/examples.inlinekeyboard2.rst
diff --git a/docs/source/examples.paymentbot.rst b/docs/source/examples.paymentbot.rst
diff --git a/docs/source/examples.pollbot.rst b/docs/source/examples.pollbot.rst
diff --git a/docs/source/examples.timerbot.rst b/docs/source/examples.timerbot.rst
diff --git a/...rce/examples.arbitrarycallbackdatabot.rst → ...rce/examples/arbitrarycallbackdatabot.rst b/...rce/examples.arbitrarycallbackdatabot.rst → ...rce/examples/arbitrarycallbackdatabot.rst
@@ -1,7 +1,8 @@
+.. Autogenerated page: False
+
 ``arbitrarycallbackdatabot.py``
 ===============================
 
-.. literalinclude:: ../../examples/arbitrarycallbackdatabot.py
+.. literalinclude:: ../../../examples/arbitrarycallbackdatabot.py
    :language: python
    :linenos:
-
diff --git a/docs/source/examples/chatmemberbot.rst b/docs/source/examples/chatmemberbot.rst
@@ -0,0 +1,8 @@
+.. Autogenerated page: False
+
+``chatmemberbot.py``
+====================
+
+.. literalinclude:: ../../../examples/chatmemberbot.py
+   :language: python
+   :linenos:
diff --git a/docs/source/examples/contexttypesbot.rst b/docs/source/examples/contexttypesbot.rst
@@ -0,0 +1,8 @@
+.. Autogenerated page: False
+
+``contexttypesbot.py``
+======================
+
+.. literalinclude:: ../../../examples/contexttypesbot.py
+   :language: python
+   :linenos:
diff --git a/docs/source/examples.conversationbot.rst → docs/source/examples/conversationbot.rst b/docs/source/examples.conversationbot.rst → docs/source/examples/conversationbot.rst
@@ -1,7 +1,9 @@
+.. Autogenerated page: False
+
 ``conversationbot.py``
 ======================
 
-.. literalinclude:: ../../examples/conversationbot.py
+.. literalinclude:: ../../../examples/conversationbot.py
    :language: python
    :linenos:
 
@@ -10,4 +12,4 @@
 State Diagram
 -------------
 
-.. mermaid:: ../../examples/conversationbot.mmd
+.. mermaid:: ../../../examples/conversationbot.mmd
diff --git a/docs/source/examples.conversationbot2.rst → docs/source/examples/conversationbot2.rst b/docs/source/examples.conversationbot2.rst → docs/source/examples/conversationbot2.rst
@@ -1,7 +1,9 @@
+.. Autogenerated page: False
+
 ``conversationbot2.py``
 =======================
 
-.. literalinclude:: ../../examples/conversationbot2.py
+.. literalinclude:: ../../../examples/conversationbot2.py
    :language: python
    :linenos:
 
@@ -10,4 +12,4 @@
 State Diagram
 -------------
 
-.. mermaid:: ../../examples/conversationbot2.mmd
+.. mermaid:: ../../../examples/conversationbot2.mmd
diff --git a/docs/source/examples.customwebhookbot.rst → docs/source/examples/customwebhookbot.rst b/docs/source/examples.customwebhookbot.rst → docs/source/examples/customwebhookbot.rst
@@ -1,3 +1,5 @@
+.. Autogenerated page: False
+
 ``customwebhookbot.py``
 =======================
 
@@ -19,25 +21,24 @@ You can select your preferred framework by opening one of the tabs above the cod
 
 .. tab:: ``starlette``
 
-    .. literalinclude:: ../../examples/customwebhookbot/starlettebot.py
+    .. literalinclude:: ../../../examples/customwebhookbot/starlettebot.py
        :language: python
        :linenos:
 
 .. tab:: ``flask``
 
-    .. literalinclude:: ../../examples/customwebhookbot/flaskbot.py
+    .. literalinclude:: ../../../examples/customwebhookbot/flaskbot.py
        :language: python
        :linenos:
 
 .. tab:: ``quart``
 
-    .. literalinclude:: ../../examples/customwebhookbot/quartbot.py
+    .. literalinclude:: ../../../examples/customwebhookbot/quartbot.py
        :language: python
        :linenos:
 
 .. tab:: ``Django``
 
-    .. literalinclude:: ../../examples/customwebhookbot/djangobot.py
+    .. literalinclude:: ../../../examples/customwebhookbot/djangobot.py
        :language: python
        :linenos:
-
diff --git a/docs/source/examples/deeplinking.rst b/docs/source/examples/deeplinking.rst
@@ -0,0 +1,8 @@
+.. Autogenerated page: False
+
+``deeplinking.py``
+==================
+
+.. literalinclude:: ../../../examples/deeplinking.py
+   :language: python
+   :linenos:
diff --git a/docs/source/examples/echobot.rst b/docs/source/examples/echobot.rst
@@ -0,0 +1,8 @@
+.. Autogenerated page: False
+
+``echobot.py``
+==============
+
+.. literalinclude:: ../../../examples/echobot.py
+   :language: python
+   :linenos:
diff --git a/docs/source/examples/errorhandlerbot.rst b/docs/source/examples/errorhandlerbot.rst
@@ -0,0 +1,8 @@
+.. Autogenerated page: False
+
+``errorhandlerbot.py``
+======================
+
+.. literalinclude:: ../../../examples/errorhandlerbot.py
+   :language: python
+   :linenos: