From e64d48a306beafa8da4eb06de69edc2c70cc9fb5 Mon Sep 17 00:00:00 2001
From: Arman Mazloumzadeh <44166374+armanexplorer@users.noreply.github.com>
Date: Sun, 28 Aug 2022 05:22:47 +0430
Subject: [PATCH] Signing-in docs: Clarify bot accounts section

As mentioned in #836 by kylethedeveloper, it will be clearer if we more explicitly mention the origin of the API ID and hash used in bot accounts signing in.
Also, the example misleads that maybe bot_token results from api_id and hash_id concatenation.

- Add some minor descriptions to the bot accounts section
- Clarify and then unify the examples
---
 readthedocs/basic/signing-in.rst | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/readthedocs/basic/signing-in.rst b/readthedocs/basic/signing-in.rst
index 05183f5c..6f679fe0 100644
--- a/readthedocs/basic/signing-in.rst
+++ b/readthedocs/basic/signing-in.rst
@@ -53,7 +53,7 @@ We can finally write some code to log into our account!
     from telethon import TelegramClient
 
     # Use your own values from my.telegram.org
-    api_id = 12345
+    api_id = 11111
     api_hash = '0123456789abcdef0123456789abcdef'
 
     async def main():
@@ -94,16 +94,21 @@ Signing In as a Bot Account
 ===========================
 
 You can also use Telethon for your bots (normal bot accounts, not users).
-You will still need an API ID and hash, but the process is very similar:
+You will still need an API ID and hash that could be retrived from *any application*
+created before.
 
+So, the process is very similar:
 
 .. code-block:: python
 
     import asyncio
     from telethon import TelegramClient
 
-    api_id = 12345
+    # Use the values retrieved from an application created in my.telegram.org
+    api_id = 11111
     api_hash = '0123456789abcdef0123456789abcdef'
+    
+    # Use the value retrieved from the bot account
     bot_token = '12345:0123456789abcdef0123456789abcdef'
 
     async def main():