Improve documentation of various types

Author: SpEcHiDe

pyrogram/methods/chats/set_slow_mode.py

@@ -37,8 +37,7 @@ async def set_slow_mode(
                 Unique identifier (int) or username (str) of the target chat.
 
             seconds (``int`` | ``None``):
-                Seconds in which members will be able to send only one message per this interval.
-                Valid values are: 0 or None (off), 10, 30, 60 (1m), 300 (5m), 900 (15m) or 3600 (1h).
+                New slow mode delay for the chat, in seconds; must be one of: 0 or None (off), 5, 10, 30, 60 (1 minute), 300 (5 minutes), 900 (15 minutes), 3600 (1 hour).
 
         Returns:
             ``bool``: True on success.

pyrogram/methods/messages/send_contact.py

@@ -63,16 +63,16 @@ async def send_contact(
                 For a contact that exists in your Telegram address book you can use his phone number (str).
 
             phone_number (``str``):
-                Contact's phone number.
+                Phone number of the user.
 
             first_name (``str``):
-                Contact's first name.
+                First name of the user; 1-64 characters.
 
             last_name (``str``, *optional*):
-                Contact's last name.
+                Last name of the user; 0-64 characters.
 
             vcard (``str``, *optional*):
-                Additional data about the contact in the form of a vCard, 0-2048 bytes
+                Additional data about the user in a form of `vCard <https://en.wikipedia.org/wiki/VCard>`_; 0-2048 bytes in length.
 
             disable_notification (``bool``, *optional*):
                 Sends the message silently.

pyrogram/types/inline_mode/inline_query_result_contact.py

@@ -34,16 +34,16 @@ class InlineQueryResultContact(InlineQueryResult):
     
     Parameters:
         phone_number (``str``):
-            Contact's phone number.
+            Phone number of the user.
 
         first_name (``str``):
-            Contact's first name.
+            First name of the user; 1-64 characters.
 
         last_name (``str``, *optional*):
-            Contact's last name.
+            Last name of the user; 0-64 characters.
 
         vcard (``str``, *optional*):
-            Additional data about the contact in the form of a `vCard <https://en.wikipedia.org/wiki/VCard>`_, 0-2048 bytes.
+            Additional data about the user in a form of `vCard <https://en.wikipedia.org/wiki/VCard>`_; 0-2048 bytes in length.
 
         id (``str``, *optional*):
             Unique identifier for this result, 1-64 bytes.

pyrogram/types/input_message_content/external_reply_info.py

@@ -28,7 +28,7 @@ class ExternalReplyInfo(Object):
     """This object contains information about a message that is being replied to, which may come from another chat or forum topic.
 
     Parameters:
-        origin (:obj:`~pyrogram.types.User`, *optional*):
+        origin (:obj:`~pyrogram.types.MessageOrigin`, *optional*):
             Origin of the message replied to by the given message
 
         chat (:obj:`~pyrogram.types.Chat`, *optional*):

pyrogram/types/input_message_content/input_contact_message_content.py

@@ -31,16 +31,16 @@ class InputContactMessageContent(InputMessageContent):
 
     Parameters:
         phone_number (``str``):
-            Contact's phone number.
+            Phone number of the user.
 
         first_name (``str``):
-            Contact's first name.
+            First name of the user; 1-64 characters.
 
         last_name (``str``, *optional*):
-            Contact's last name.
+            Last name of the user; 0-64 characters.
 
         vcard (``str``, *optional*):
-            Additional data about the contact in the form of a `vCard <https://en.wikipedia.org/wiki/VCard>`_, 0-2048 bytes.
+            Additional data about the user in a form of `vCard <https://en.wikipedia.org/wiki/VCard>`_; 0-2048 bytes in length.
 
     """
 

pyrogram/types/messages_and_media/contact.py

@@ -26,19 +26,20 @@ class Contact(Object):
 
     Parameters:
         phone_number (``str``):
-            Contact's phone number.
+            Phone number of the user.
 
         first_name (``str``):
-            Contact's first name.
+            First name of the user; 1-64 characters.
 
         last_name (``str``, *optional*):
-            Contact's last name.
+            Last name of the user; 0-64 characters.
 
         user_id (``int``, *optional*):
             Contact's user identifier in Telegram.
 
         vcard (``str``, *optional*):
-            Additional data about the contact in the form of a vCard.
+            Additional data about the user in a form of `vCard <https://en.wikipedia.org/wiki/VCard>`_; 0-2048 bytes in length.
+
     """
 
     def __init__(

pyrogram/types/messages_and_media/message.py

@@ -2358,21 +2358,21 @@ async def reply_contact(
 
         Parameters:
             phone_number (``str``):
-                Contact's phone number.
+                Phone number of the user.
 
             first_name (``str``):
-                Contact's first name.
+                First name of the user; 1-64 characters.
 
             quote (``bool``, *optional*):
                 If ``True``, the message will be sent as a reply to this message.
                 If *reply_to_message_id* is passed, this parameter will be ignored.
                 Defaults to ``True`` in group chats and ``False`` in private chats.
 
             last_name (``str``, *optional*):
-                Contact's last name.
+                Last name of the user; 0-64 characters.
 
             vcard (``str``, *optional*):
-                Additional data about the contact in the form of a vCard, 0-2048 bytes
+                Additional data about the user in a form of `vCard <https://en.wikipedia.org/wiki/VCard>`_; 0-2048 bytes in length.
 
             disable_notification (``bool``, *optional*):
                 Sends the message silently.

pyrogram/types/stories/story.py

@@ -83,7 +83,7 @@ class Story(Object, Update):
             Clickable areas to be shown on the story content.
 
         has_protected_content (``bool``, *optional*):
-            True, if the story can't be forwarded.
+            True, if the story can't be forwarded as a message or reposted as a story.
 
         reactions (List of :obj:`~pyrogram.types.Reaction`):
             List of the reactions to this story.

pyrogram/types/user_and_chats/chat.py

@@ -111,7 +111,7 @@ class Chat(Object):
             Returned only in :meth:`~pyrogram.Client.get_chat`.
 
         join_by_request (``bool``, *optional*):
-            True, if all users directly joining the supergroup need to be approved by supergroup administrators.
+            True, if all users directly joining the supergroup need to be approved by supergroup administrators. Can be True only for non-broadcast supergroups with username, location, or a linked chat.
 
         description (``str``, *optional*):
             Description, for groups, supergroups and channel chats.