Update missing links in the documentation summary

telethon/client/messages.py

@@ -1122,6 +1122,8 @@ class MessageMethods:
         If neither message nor maximum ID are provided, all messages will be
         marked as read by assuming that ``max_id = 0``.
 
+        See also `Message.mark_read() <telethon.tl.custom.message.Message.mark_read>`.
+
         Arguments
             entity (`entity`):
                 The chat where these messages are located.

telethon/tl/custom/conversation.py

@@ -250,6 +250,12 @@ class Conversation(ChatGetter):
         """
         Waits for a custom event to occur. Timeouts still apply.
 
+        .. note::
+
+            Only use this if there isn't another method available!
+            For example, don't use `wait_event` for new messages,
+            since `get_response` already exists, etc.
+
         Unless you're certain that your code will run fast enough,
         generally you should get a "handle" of this special coroutine
         before acting. Generally, you should do this:

telethon/tl/custom/file.py

@@ -22,6 +22,14 @@ class File:
     def id(self):
         """
         The bot-API style ``file_id`` representing this file.
+
+        .. note::
+
+            This file ID may not work under user accounts,
+            but should still be usable by bot accounts.
+
+            You can, however, still use it to identify
+            a file in for example a database.
         """
         return utils.pack_bot_file_id(self.media)