diff --git a/README.md b/README.md
index 4d467f2..a26a10d 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,14 @@
 # Mastodon.py
+
+    mastodon = Mastodon(
+        client_id = 'pytooter_clientcred.txt',
+        access_token = 'pytooter_usercred.txt'
+    )
+    mastodon.toot('Tooting from python!')
+
+
 Python wrapper for the Mastodon ( https://github.com/Gargron/mastodon/ ) API.
 
-Media uploads currently broken, will be fixed Soon. Documentation and usage examples also
-incoming, but the code is heavily commented and usage frankly rather self-explanatory.
+Full documentation and usage example can be found at http://mastodonpy.readthedocs.io/en/latest/ .
+
+Media uploads currently broken, will be fixed Soon.
diff --git a/docs/index.rst b/docs/index.rst
index 06c3678..d5e3402 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -118,7 +118,8 @@ Writing data: Media
 -------------------
 This function allows you to upload media to Mastodon. Except it 
 doesn't, because it is currently broken. But it will.
-.. automethod:: media_post
+
+.. automethod:: Mastodon.media_post
 
 .. _Mastodon: https://github.com/Gargron/mastodon
 .. _Mastodon flagship instance: http://mastodon.social/