Documentation Improvements (#5119)

Co-authored-by: Poolitzer <github@poolitzer.eu>
Co-authored-by: Harshil <37377066+harshil21@users.noreply.github.com>

.readthedocs.yml

@@ -20,7 +20,7 @@ python:
       path: .
 
 build:
-  os: ubuntu-22.04
+  os: ubuntu-24.04
   tools:
     python: "3"  # latest stable cpython version
   jobs:

AUTHORS.rst

@@ -5,13 +5,12 @@ Credits
 `Leandro Toledo <https://github.com/leandrotoledo>`_.
 The current development team includes
 
-- `Hinrich Mahler <https://github.com/Bibo-Joshi>`_ (maintainer)
+- `Poolitzer <https://github.com/Poolitzer>`_ (maintainer)
-- `Poolitzer <https://github.com/Poolitzer>`_ (community liaison)
+- `Harshil <https://github.com/harshil21>`_ (maintainer)
-- `Harshil <https://github.com/harshil21>`_
 - `Abdelrahman <https://github.com/aelkheir>`_
 
 Emeritus maintainers include
-`Jannes Höke <https://github.com/jh0ker>`_ (`@jh0ker <https://t.me/jh0ker>`_ on Telegram),
+`Hinrich Mahler <https://github.com/Bibo-Joshi>`_, `Jannes Höke <https://github.com/jh0ker>`_ (`@jh0ker <https://t.me/jh0ker>`_ on Telegram),
 `Noam Meltzer <https://github.com/tsnoam>`_, `Pieter Schutz <https://github.com/eldinnie>`_ and `Jasmin Bom <https://github.com/jsmnbom>`_.
 
 Contributors

changes/unreleased/5119.CA8avHeQnMdHNFQKvonFK6.toml

@@ -0,0 +1,5 @@
+highlights = "Hand over Maintainer Role from `Bibo-Joshi <https://github.com/Bibo-Joshi>`_ to `Poolitzer <https://github.com/Poolitzer>`_ and `Harshil <https://github.com/harshil21>`_"
+
+[[pull_requests]]
+uid = "5119"
+author_uids = ["Bibo-Joshi"]

docs/source/conf.py

@@ -126,6 +126,10 @@ linkcheck_ignore = [
     re.escape("https://docs.python-telegram-bot.org/en/doc-fixes"),
     # Apparently has some human-verification check and gives 403 in the sphinx build
     re.escape("https://stackoverflow.com/questions/tagged/python-telegram-bot"),
+    # Dead Github accounts:
+    re.escape("https://github.com/SmartDever02"),
+    re.escape("https://github.com/renovate[bot]"),
+    re.escape("https://github.com/roast-lord"),
 ]
 linkcheck_allowed_redirects = {
     # Redirects to the default version are okay

src/telegram/_bot.py

@@ -5964,7 +5964,6 @@ class Bot(TelegramObject, contextlib.AbstractAsyncContextManager["Bot"]):
                 administrator privilege.
 
                 .. versionadded:: 13.4
-
             can_manage_video_chats (:obj:`bool`, optional): Pass :obj:`True`, if the administrator
                 can manage video chats.
 
@@ -6000,7 +5999,7 @@ class Bot(TelegramObject, contextlib.AbstractAsyncContextManager["Bot"]):
                 .. versionadded:: 20.6
             can_edit_stories (:obj:`bool`, optional): Pass :obj:`True`, if the administrator can
                 edit stories posted by other users, post stories to the chat page, pin chat
-                stories, and access the chat's story archive
+                stories, and access the chat's story archive.
 
                 .. versionadded:: 20.6
             can_delete_stories (:obj:`bool`, optional): Pass :obj:`True`, if the administrator can
@@ -6009,7 +6008,7 @@ class Bot(TelegramObject, contextlib.AbstractAsyncContextManager["Bot"]):
                 .. versionadded:: 20.6
             can_manage_direct_messages (:obj:`bool`, optional): Pass :obj:`True`, if the
                 administrator can manage direct messages within the channel and decline suggested
-                posts; for channels only
+                posts; for channels only.
 
                 .. versionadded:: 22.4
             can_manage_tags (:obj:`bool`, optional): Pass :obj:`True`, if the administrator can

src/telegram/_chatmember.py

@@ -322,7 +322,7 @@ class ChatMemberAdministrator(ChatMember):
 
             .. versionadded:: 20.0
         custom_title (:obj:`str`): Optional. Custom title for this user.
-        can_manage_direct_messages (:obj:`bool`, optional): :obj:`True`, if the administrator can
+        can_manage_direct_messages (:obj:`bool`): Optional. :obj:`True`, if the administrator can
             manage direct messages of the channel and decline suggested posts; for channels only.
 
             .. versionadded:: 22.4