Update external links to the documentation

README.rst

@@ -75,7 +75,7 @@ useful information.
 .. _asyncio: https://docs.python.org/3/library/asyncio.html
 .. _MTProto: https://core.telegram.org/mtproto
 .. _Telegram: https://telegram.org
-.. _Compatibility and Convenience: https://telethon.readthedocs.io/en/latest/extra/basic/compatibility-and-convenience.html
+.. _Compatibility and Convenience: https://telethon.readthedocs.io/en/latest/misc/compatibility-and-convenience.html
 .. _Read The Docs: https://telethon.readthedocs.io
 
 .. |logo| image:: logo.svg

readthedocs/basic/signing-in.rst

@@ -119,7 +119,7 @@ with
 
     TelegramClient('anon', api_id, api_hash, proxy=(socks.SOCKS5, '127.0.0.1', 4444))
 
-(of course, replacing the IP and port with the IP and port of the proxye).
+(of course, replacing the IP and port with the IP and port of the proxy).
 
 The ``proxy=`` argument should be a tuple, a list or a dict,
 consisting of parameters described `in PySocks usage`__.

readthedocs/quick-references/faq.rst

@@ -47,12 +47,12 @@ And except them as such:
 
 .. code-block:: python
 
-    import time
     try:
         client.send_message(chat, 'Hi')
-    except FloodWaitError as e:
+    except errors.FloodWaitError as e:
+        # e.seconds is how many seconds you have
+        # to wait before making the request again.
         print('Flood for', e.seconds)
-        time.sleep(e.seconds)
 
 
 My account was deleted/limited when using the library

telethon/client/users.py

@@ -394,7 +394,7 @@ class UserMethods(TelegramBaseClient):
 
         raise ValueError(
             'Could not find the input entity for {!r}. Please read https://'
-            'telethon.readthedocs.io/en/latest/extra/basic/entities.html to'
+            'telethon.readthedocs.io/en/latest/concepts/entities.html to'
             ' find out more details.'
             .format(peer)
         )

telethon_examples/README.md

@@ -116,4 +116,4 @@ assumes some [`asyncio`] knowledge, but otherwise is easy to follow.
 [`asyncio`]: https://docs.python.org/3/library/asyncio.html
 [`tkinter`]: https://docs.python.org/3/library/tkinter.html
 [tkinter GUI]: https://raw.githubusercontent.com/LonamiWebs/Telethon/master/telethon_examples/screenshot-gui.jpg
-[`events.NewMessage`]: https://telethon.readthedocs.io/en/stable/telethon.events.html#telethon.events.newmessage.NewMessage
+[`events.NewMessage`]: https://telethon.readthedocs.io/en/latest/modules/events.html#telethon.events.newmessage.NewMessage

telethon_examples/assistant.py

@@ -55,7 +55,7 @@ WELCOME = {
 
 READ_FULL = (
     'Please read [Accessing the Full API](https://telethon.readthedocs.io'
-    '/en/latest/extra/advanced-usage/accessing-the-full-api.html)'
+    '/en/latest/concepts/full-api.html)'
 )
 
 SEARCH = (
@@ -68,12 +68,12 @@ RTD = '[Read The Docs!](https://telethon.readthedocs.io)'
 RTFD = '[Read The F* Docs!](https://telethon.readthedocs.io)'
 UPDATES = (
     'Check out [Working with Updates](https://telethon.readthedocs.io'
-    '/en/latest/extra/basic/working-with-updates.html) in the documentation.'
+    '/en/latest/basic/updates.html) in the documentation.'
 )
-DOCS_CLIENT = 'https://telethon.readthedocs.io/en/latest/telethon.client.html#'
+DOCS_CLIENT = 'https://telethon.readthedocs.io/en/latest/modules/client.html#'
 DOCS_MESSAGE = (
     'https://telethon.readthedocs.io/en/latest/'
-    'telethon.tl.custom.html#telethon.tl.custom.message.Message.'
+    'modules/custom.html#telethon.tl.custom.message.Message.'
 )
 
 SPAM = (

telethon_generator/data/html/core.html

@@ -59,7 +59,7 @@ users.getUsers#0d91a548 id:Vector&lt;InputUser&gt; = Vector&lt;User&gt;</pre>
     <p>This is <b>not</b> Python code. It's the "TL definition". It's
     an easy-to-read line that gives a quick overview on the parameters
     and its result. You don't need to worry about this. See
-    <a href="https://telethon.readthedocs.io/en/latest/extra/developing/understanding-the-type-language.html">Understanding
+    <a href="https://telethon.readthedocs.io/en/latest/developing/understanding-the-type-language.html">Understanding
     the Type Language</a> for more details on it.</p>
 
     <h3>Index</h3>
@@ -175,7 +175,7 @@ users.getUsers#0d91a548 id:Vector&lt;InputUser&gt; = Vector&lt;User&gt;</pre>
     not always run. They are just there to show the right syntax.</p>
 
     <p>You should check out
-    <a href="http://telethon.readthedocs.io/en/latest/extra/advanced-usage/accessing-the-full-api.html">how
+    <a href="https://telethon.readthedocs.io/en/latest/concepts/full-api.html">how
     to access the full API</a> in ReadTheDocs.
     </p>
 </div>