1 files changed, 17 insertions, 0 deletions

diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..1999c46
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,17 @@
+# 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. 
+Feature complete for public API version v1 and easy to get started with.
+
+Full documentation and basic "how to post a toot" usage example can be found 
+at http://mastodonpy.readthedocs.io/en/latest/ .
+
+Full "real life" example of how to use this library to write a Mastodon bot 
+will be linked here shortly.