README.md in git-flattr-0.0.10 vs README.md in git-flattr-0.0.11

@@ -1,4 +1,51 @@
-git-flattr
-==========
+```
+       _ _      __ _       _   _        
+  __ _(_) |_   / _| | __ _| |_| |_ _ __ 
+ / _` | | __| | |_| |/ _` | __| __| '__|
+| (_| | | |_  |  _| | (_| | |_| |_| |   
+ \__, |_|\__| |_| |_|\__,_|\__|\__|_|   
+ |___/                                  
+```
 
-This is a gem that makes it easy to Flattr GitHub repositories and commits from the command line. It's still in early development and currently you can only flattr repositories.
+# What is Flattr?
+
+Flattr is a social microdonation service that makes it a breeze to donate to open source projects, music artists, podcaster and blogger. You can read more about it on [http://flattr.com](http://flattr.com).
+
+# But why git and Flattr?
+
+I play around with open source a great deal and most of the projects are available on github. So I made a command line tool where you can easily flattr the currently checked out repo.
+
+
+# Install
+
+`git flattr` is distributed as a Ruby Gem.
+
+`gem install git-flattr`
+
+This will make the command `git flattr` available. For futher help run `git flattr help`
+
+# Usage
+
+You can both flattr repositories and individual commits.
+
+## Flattr a repository
+
+When you are in a directory with a git GitHub repository you can easily flattr the repository.
+
+`git flattr repo`
+
+## Flattr a commit
+
+When you are in a directory with a git GitHub repository you can easily flattr a commit. You need the commit sha1, to view history run `git log`. Then copy the sha1 of the commit you would like to flattr and run this command.
+
+`git flattr commit [sha1]`
+
+## Want to know more?
+
+If you wan't to know more about the commands check out the help.
+
+`git flattr`
+
+# Copyright
+
+Copyright (c) 2012 Simon Gate. See LICENSE for details.