Slightly change docs for events (#668)

readthedocs/extra/basic/getting-started.rst

@@ -66,6 +66,26 @@ Basic Usage
    **More details**: :ref:`telegram-client`
 
 
+Handling Updates
+****************
+
+   .. code-block:: python
+
+       from telethon import events
+
+       # We need to have some worker running
+       client.updates.workers = 1
+
+       @client.on(events.NewMessage(incoming=True, pattern='(?i)hi'))
+       def handler(event):
+           event.reply('Hello!')
+
+       # If you want to handle updates you can't let the script end.
+       input('Press enter to exit.')
+
+   **More details**: :ref:`working-with-updates`
+
+
 ----------
 
 You can continue by clicking on the "More details" link below each

telethon/events/__init__.py

@@ -37,8 +37,10 @@ class _EventBuilder(abc.ABC):
             only matching chats will be handled.
 
         blacklist_chats (:obj:`bool`, optional):
-            Whether to treat the the list of chats as a blacklist (if
-            it matches it will NOT be handled) or a whitelist (default).
+            Whether to treat the chats as a blacklist instead of
+            as a whitelist (default). This means that every chat
+            will be handled *except* those specified in ``chats``
+            which will be ignored if ``blacklist_chats=True``.
     """
     def __init__(self, chats=None, blacklist_chats=False):
         self.chats = chats