Add Documentation / Update Readme

[thekar]

The documentation standalone is not understandable without hours of DIY.

Main issues:

How to add multiple files, concatenate, minify, compress?
Give examples to ALL functionalities. E.g. function "write":
it says it takes 3 params. but you dont just need 3 params, but ONE param as array with 3 values. An example just solves this.
Directives are totally uncomprehensive. Example?

Keep on the great work.