diff --git a/README.rst b/README.rst
index 11198330..7e3fd3cd 100755
--- a/README.rst
+++ b/README.rst
@@ -8,9 +8,9 @@ Telethon
 <https://docs.python.org/3/library/asyncio.html>`_ **Python 3** library
 to interact with Telegram's API.
 
-If you don't like ``asyncio``, you can still use `a simpler version
-<https://github.com/LonamiWebs/Telethon/tree/sync>`_ that uses threads instead.
-
+**If you're upgrading from Telethon pre-1.0 to 1.0, please make sure to read**
+`this section of the documentation
+<https://telethon.readthedocs.io/en/latest/extra/basic/asyncio-magic.html>`_.
 
 What is this?
 -------------
diff --git a/readthedocs/extra/basic/asyncio-magic.rst b/readthedocs/extra/basic/asyncio-magic.rst
index 69a38bba..48ab9943 100644
--- a/readthedocs/extra/basic/asyncio-magic.rst
+++ b/readthedocs/extra/basic/asyncio-magic.rst
@@ -4,6 +4,22 @@
 Magic with asyncio
 ==================
 
+.. important::
+
+    TL; DR; If you've upgraded to Telethon 1.0 from a previous version
+    **and you're not using events or updates**, add this line:
+
+    .. code-block:: python
+
+        import telethon.sync
+
+    At the beginning of your main script and you will be good. If you
+    do use updates or events, keep reading, or use `a simpler version
+    <https://github.com/LonamiWebs/Telethon/tree/sync>`_ (discouraged).
+
+    You might also want to check the :ref:`changelog`.
+
+
 The sync module
 ***************