Document undocumented properties

delivrance · delivrance · commit c5dd474f935f · 2020-08-26T08:10:34.000+02:00
diff --git a/compiler/docs/compiler.py b/compiler/docs/compiler.py
@@ -416,7 +416,8 @@ def get_title_list(s: str) -> list:
                     title = "{}".format(type)
 
                     f2.write(title + "\n" + "=" * len(title) + "\n\n")
-                    f2.write(".. autoclass:: pyrogram.types.{}()".format(type))
+                    f2.write(".. autoclass:: pyrogram.types.{}()\n".format(type))
+                    f2.write("    :members:\n")
 
         f.write(template.format(**fmt_keys))
 
diff --git a/pyrogram/types/messages_and_media/message.py b/pyrogram/types/messages_and_media/message.py
@@ -245,9 +245,6 @@ class Message(Object, Update):
             Messages sent from yourself to other chats are outgoing (*outgoing* is True).
             An exception is made for your own personal chat; messages sent there will be incoming.
 
-        link (``str``):
-            A link to the message, only for groups and channels.
-
         matches (List of regex Matches, *optional*):
             A list containing all `Match Objects <https://docs.python.org/3/library/re.html#match-objects>`_ that match
             the text of this message. Only applicable when using :obj:`Filters.regex <pyrogram.Filters.regex>`.
@@ -675,6 +672,7 @@ async def _parse(
 
     @property
     def link(self) -> str:
+        """Generate a link to this message, only for groups and channels."""
         if self.chat.type in ("group", "supergroup", "channel") and self.chat.username:
             return f"https://t.me/{self.chat.username}/{self.message_id}"
         else:
diff --git a/pyrogram/types/user_and_chats/user.py b/pyrogram/types/user_and_chats/user.py
@@ -192,6 +192,11 @@ def __init__(
 
     @property
     def mention(self):
+        """Generate a text mention for this user.
+
+        You can use ``user.mention()`` to mention the user using their first name (styled using html), or
+        ``user.mention("another name")`` for a custom name. To choose a different style
+        ("html" or "md"/"markdown") use ``user.mention(style="md")``."""
         return Link(f"tg://user?id={self.id}", self.first_name, self._client.parse_mode)
 
     @staticmethod
