diff --git a/README.md b/README.md
index a26a10d..1999c46 100644
--- a/README.md
+++ b/README.md
@@ -7,8 +7,11 @@
     mastodon.toot('Tooting from python!')
 
 
-Python wrapper for the Mastodon ( https://github.com/Gargron/mastodon/ ) API.
+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 usage example can be found at http://mastodonpy.readthedocs.io/en/latest/ .
+Full documentation and basic "how to post a toot" usage example can be found 
+at http://mastodonpy.readthedocs.io/en/latest/ .
 
-Media uploads currently broken, will be fixed Soon.
+Full "real life" example of how to use this library to write a Mastodon bot 
+will be linked here shortly.