Docs linked

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.

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/