1 files changed, 30 insertions, 2 deletions
diff --git a/README.md b/README.md
index b003ce0..6d37943 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,32 @@
-gitbook
+GitBook
 =======
 
-Library and command line utility for generating GitBooks
+GiBook is a command line tool (and Node.js library) for building beautiful programming books and exercises using GitHub/Git and Markdown.
+
+## How to use it:
+
+GitBook can be installed from **NPM** using:
+
+```
+$ npm install gitbook -g
+```
+
+You can serve a repository as a book using:
+
+```
+$ gitbook serve ./repository
+```
+
+Or simply build the static website using:
+
+```
+$ gitbook build ./repository --output=./outputFolder
+```
+
+Options for commands `build` and `serve` are:
+
+```
+-t, --title <name> Name of the book to generate, defaults to repo name
+-i, --intro <intro> Description of the book to generate
+-g, --github <repo_path> ID of github repo like : username/repo
+```