updated readme

README.md

@@ -1,8 +1,27 @@
 **Table of Contents**  *generated with [DocToc](http://doctoc.herokuapp.com/)*
 
-- [doc-toc](#doc-toc)
+- [DocToc](#doctoc)
+	- [Installation](#installation)
+	- [Usage](#usage)
 
-doc-toc
-=======
+# DocToc
+
+Generates table of contents for markdown files inside local git repository. Links are compatible with anchors generated by github
+
+## Installation
+
+    npm install -g doctoc
+
+## Usage
+
+Go into the directory that contains you local git project and type:
+
+    doctoc .
+
+This will update all markdow files with a table of content. 
+
+You can then check it in, e.g.,:
+
+    git commit -ma "updated markdown table of contents"
+    git push
 
-Generates table of contents for markdown files inside local git repository. Links are compatible with anchors generated by github