fix: some docstrings

Author: KurimuzonAkuma

pyrogram/methods/messages/copy_media_group.py

@@ -73,8 +73,8 @@ async def copy_media_group(
                 If not specified, the original caption is kept.
                 Pass "" (empty string) to remove the caption.
 
-                If a ``string`` is passed, it becomes a caption only for the first media.
-                If a list of ``string`` passed, each element becomes caption for each media element.
+                If a ``str`` is passed, it becomes a caption only for the first media.
+                If a list of ``str`` passed, each element becomes caption for each media element.
                 You can pass ``None`` in list to keep the original caption (see examples below).
 
             disable_notification (``bool``, *optional*):

pyrogram/methods/messages/copy_message.py

@@ -74,7 +74,7 @@ async def copy_message(
             message_id (``int``):
                 Message identifier in the chat specified in *from_chat_id*.
 
-            caption (``string``, *optional*):
+            caption (``str``, *optional*):
                 New caption for media, 0-1024 characters after entities parsing.
                 If not specified, the original caption is kept.
                 Pass "" (empty string) to remove the caption.

pyrogram/methods/messages/send_poll.py

@@ -31,6 +31,7 @@ async def send_poll(
         chat_id: Union[int, str],
         question: Union[str, "types.FormattedText"],
         options: List[Union[str, "types.InputPollOption"]],
+        description: Optional[Union[str, "types.FormattedText"]] = None,
         description_media: Optional["types.InputMedia"] = None,
         message_thread_id: Optional[int] = None,
         business_connection_id: Optional[str] = None,
@@ -47,7 +48,6 @@ async def send_poll(
         open_period: Optional[int] = None,
         close_date: Optional[datetime] = None,
         is_closed: Optional[bool] = None,
-        description: Optional[Union[str, "types.FormattedText"]] = None,
         disable_notification: Optional[bool] = None,
         protect_content: Optional[bool] = None,
         allow_paid_broadcast: Optional[bool] = None,
@@ -87,7 +87,10 @@ async def send_poll(
             options (List of :obj:`~pyrogram.types.InputPollOption`):
                 List of 2-12 answer options.
 
-            explanation_media (:obj:`~pyrogram.types.InputMedia` | :obj:`~pyrogram.types.Location`, *optional*):
+            description (``str`` | :obj:`~pyrogram.types.FormattedText`, *optional*):
+                Description of the poll to be sent, 0-1024 characters after entities parsing.
+
+            description_media (:obj:`~pyrogram.types.InputMedia` | :obj:`~pyrogram.types.Location`, *optional*):
                 Media attached to the poll.
 
             message_thread_id (``int``, *optional*):
@@ -145,9 +148,6 @@ async def send_poll(
                 This can be useful for poll preview.
                 For bots only.
 
-            description (``str`` | :obj:`~pyrogram.types.FormattedText`, *optional*):
-                Description of the poll to be sent, 0-1024 characters after entities parsing.
-
             disable_notification (``bool``, *optional*):
                 Sends the message silently.
                 Users will receive a notification with no sound.

pyrogram/methods/stories/copy_story.py

@@ -57,7 +57,7 @@ async def copy_story(
             story_id (``int``):
                 Message identifier in the chat specified in *from_chat_id*.
 
-            caption (``string``, *optional*):
+            caption (``str``, *optional*):
                 New caption for story, 0-1024 characters after entities parsing.
                 If not specified, the original caption is kept.
                 Pass "" (empty string) to remove the caption.

pyrogram/types/messages_and_media/auction_bid.py

@@ -30,7 +30,7 @@ class AuctionBid(Object):
         star_count (``int``):
             The number of Telegram Stars that were put in the bid.
 
-        bid_date (``datetime``):
+        bid_date (:py:obj:`~datetime.datetime`):
             Date when the bid was made.
 
         position (``int``):

pyrogram/types/messages_and_media/dice.py

@@ -25,7 +25,7 @@ class Dice(Object):
     """A dice with a random value from 1 to 6 for currently supported base emoji.
 
     Parameters:
-        emoji (``string``):
+        emoji (``str``):
             Emoji on which the dice throw animation is based.
 
         value (``int``):

pyrogram/types/messages_and_media/message.py

@@ -8615,7 +8615,7 @@ async def copy(
                 For your personal cloud (Saved Messages) you can simply use "me" or "self".
                 For a contact that exists in your Telegram address book you can use his phone number (str).
 
-            caption (``string``, *optional*):
+            caption (``str``, *optional*):
                 New caption for media, 0-1024 characters after entities parsing.
                 If not specified, the original caption is kept.
                 Pass "" (empty string) to remove the caption.
@@ -8864,8 +8864,8 @@ async def copy_media_group(
                 If not specified, the original caption is kept.
                 Pass "" (empty string) to remove the caption.
 
-                If a ``string`` is passed, it becomes a caption only for the first media.
-                If a list of ``string`` passed, each element becomes caption for each media element.
+                If a ``str`` is passed, it becomes a caption only for the first media.
+                If a list of ``str`` passed, each element becomes caption for each media element.
                 You can pass ``None`` in list to keep the original caption.
 
             disable_notification (``bool``, *optional*):

pyrogram/types/messages_and_media/story.py

@@ -1729,7 +1729,7 @@ async def copy(
                 Unique identifier (int) or username (str) of the target chat.
                 For your personal stories you can simply use "me" or "self".
 
-            caption (``string``, *optional*):
+            caption (``str``, *optional*):
                 New caption for story, 0-1024 characters after entities parsing.
                 If not specified, the original caption is kept.
                 Pass "" (empty string) to remove the caption.