diff --git a/README.rst b/README.rst
index febc43cd..7a2183fc 100755
--- a/README.rst
+++ b/README.rst
@@ -32,12 +32,18 @@ Creating a client
 
   from telethon import TelegramClient
 
-  # These example values won't work. You must get your own api_id and
-  # api_hash from https://my.telegram.org, under API Development.
+  # Replace these example values with your own before starting. 
+  # You must get your own api_id and api_hash from 
+  # https://my.telegram.org, under API Development.
+  
   api_id = 12345
   api_hash = '0123456789abcdef0123456789abcdef'
 
-  client = TelegramClient('session_name', api_id, api_hash)
+  client = TelegramClient(
+      'session_name',  # Any string to identify the session
+      api_id, 
+      api_hash
+  )
   client.start()