Update documentation

docs/source/index.rst

@@ -141,9 +141,9 @@ Meta
     topics/create-filters
     topics/more-on-updates
     topics/client-settings
-    topics/synchronous
-    topics/text-formatting
     topics/speedups
+    topics/text-formatting
+    topics/synchronous
     topics/smart-plugins
     topics/storage-engines
     topics/serializing

docs/source/topics/speedups.rst

@@ -45,21 +45,44 @@ Installation
 Usage
 ^^^^^
 
-Call ``uvloop.install()`` before calling ``asyncio.run()`` or ``app.run()``
+Call ``uvloop.install()`` before calling ``asyncio.run()`` or ``app.run()``.
 
 .. code-block:: python
 
     import asyncio
     import uvloop
 
+    from pyrogram import Client
+
+
     async def main():
         app = Client("my_account")
 
         async with app:
             print(await app.get_me())
 
+
     uvloop.install()
     asyncio.run(main())
 
+The ``uvloop.install()`` call also needs to be placed before creating a Client instance.
+
+.. code-block:: python
+
+    import uvloop
+    from pyrogram import Client
+
+    uvloop.install()
+
+    app = Client("my_account")
+
+
+    @app.on_message()
+    async def hello(client, message):
+        print(await client.get_me())
+
+
+    app.run()
+
 .. _TgCrypto: https://github.com/pyrogram/tgcrypto
 .. _uvloop: https://github.com/MagicStack/uvloop

docs/source/topics/synchronous.rst

@@ -71,3 +71,18 @@ possible.
     @app.on_edited_message()
     def handler2(client, message):
         message.forward("me")
+
+uvloop usage
+------------
+
+When using Pyrogram in its synchronous mode combined with uvloop, you need to call ``uvloop.install()`` before importing
+Pyrogram.
+
+.. code-block:: python
+
+    import uvloop
+    uvloop.install()
+
+    from pyrogram import Client
+
+    ...