diff --git a/README.md b/README.md
new file mode 100644
index 0000000..a768f12
--- /dev/null
+++ b/README.md
@@ -0,0 +1,30 @@
+# mustache.js
+
+> What could be more logical awesome than no logic at all?
+
+Shamless port of http://github.com/defunkt/mustache 
+by Jan Lehnardt <jan@apache.org>.
+
+Thanks @defunkt for the awesome code.
+
+
+## Usage
+
+  // load mustache.js
+  
+  var view = {
+    title: "foo",
+    calc: function() {
+      return 2 + 4;
+    }
+  }
+  
+  var template = "{{title}} spends {{calc}}";
+  
+  var html = Mustache.to_html(template, view);
+  
+  // whatever you want to do with html
+
+See `examples/` for more goodies and read the [original mustache docs][m]
+
+[m]: http://github.com/defunkt/mustache/
diff --git a/mustache.js b/mustache.js
index 33012ee..6bbee66 100644
--- a/mustache.js
+++ b/mustache.js
@@ -1,13 +1,8 @@
 /*
   Shamless port of http://github.com/defunkt/mustache
-    by Jan Lehnardt <jan@apache.org>
+  by Jan Lehnardt <jan@apache.org>
 
   Thanks @defunkt for the awesome code
-  TBD: MIT, see LICENSE
-  
-  ChangeLog:
-   - 04.10.2009: Ininitial port at http://devhouseberlin.de/
-
 */
 
 var Mustache = {