Completely overhaul the documentation

telethon/events/__init__.py

@@ -42,7 +42,7 @@ class StopPropagation(Exception):
 def register(event=None):
     """
     Decorator method to *register* event handlers. This is the client-less
-    `add_event_handler
+    `add_event_handler()
     <telethon.client.updates.UpdateMethods.add_event_handler>` variant.
 
     Note that this method only registers callbacks as handlers,

telethon/events/inlinequery.py

@@ -178,6 +178,20 @@ class InlineQuery(EventBuilder):
                 switch_pm_param (`str`, optional):
                     Optional parameter to start the bot with if
                     `switch_pm` was used.
+
+            Example:
+
+                .. code-block:: python
+
+                    @bot.on(events.InlineQuery)
+                    async def handler(event):
+                        builder = event.builder
+
+                        rev_text = event.text[::-1]
+                        await event.answer([
+                            builder.article('Reverse text', text=rev_text),
+                            builder.photo('/path/to/photo.jpg')
+                        ])
             """
             if self._answered:
                 return

telethon/events/messageread.py

@@ -95,7 +95,7 @@ class MessageRead(EventBuilder):
 
         async def get_messages(self):
             """
-            Returns the list of `telethon.tl.custom.message.Message`
+            Returns the list of `Message <telethon.tl.custom.message.Message>`
             **which contents'** were read.
 
             Use :meth:`is_read` if you need to check whether a message

telethon/events/userupdate.py

@@ -190,23 +190,23 @@ class UserUpdate(EventBuilder):
 
         @property
         def user(self):
-            """Alias for `sender`."""
+            """Alias for `sender <telethon.tl.custom.sendergetter.SenderGetter.sender>`."""
             return self.sender
 
         async def get_user(self):
-            """Alias for `get_sender`."""
+            """Alias for `get_sender <telethon.tl.custom.sendergetter.SenderGetter.get_sender>`."""
             return await self.get_sender()
 
         @property
         def input_user(self):
-            """Alias for `input_sender`."""
+            """Alias for `input_sender <telethon.tl.custom.sendergetter.SenderGetter.input_sender>`."""
             return self.input_sender
 
         async def get_input_user(self):
-            """Alias for `get_input_sender`."""
+            """Alias for `get_input_sender <telethon.tl.custom.sendergetter.SenderGetter.get_input_sender>`."""
             return await self.get_input_sender()
 
         @property
         def user_id(self):
-            """Alias for `sender_id`."""
+            """Alias for `sender_id <telethon.tl.custom.sendergetter.SenderGetter.sender_id>`."""
             return self.sender_id