1 files changed, 14 insertions, 5 deletions

diff --git a/README.rst b/README.rst
index 97919e0..39923b9 100644
--- a/README.rst
+++ b/README.rst
@@ -1,10 +1,11 @@
 Mastodon.py
 ===========
+Register your app! This only needs to be done once. Uncomment the code and substitute in your information.
+
 .. code-block:: python
 
    from mastodon import Mastodon
 
-   # Register app - only once!
    '''
    Mastodon.create_app(
         'pytooterapp',
@@ -13,8 +14,12 @@ Mastodon.py
    )
    '''
 
-   # Log in - either every time, or use persisted
-   '''
+Then login. This can be done every time, or use persisted.
+
+.. code-block:: python
+
+   from mastodon import Mastodon
+   
    mastodon = Mastodon(
        client_id = 'pytooter_clientcred.secret',
        api_base_url = 'https://mastodon.social'
@@ -24,9 +29,13 @@ Mastodon.py
        'incrediblygoodpassword',
        to_file = 'pytooter_usercred.secret'
    )
-   '''
 
-   # Create actual API instance
+To post, create an actual API instance.
+
+.. code-block:: python
+
+   from mastodon import Mastodon
+   
    mastodon = Mastodon(
        access_token = 'pytooter_usercred.secret',
        api_base_url = 'https://mastodon.social'