Updates and Documentation

Hi @oliviert,

First of all congratulations for your job, you have a very powerful repo here.
Unfortunately it's not documented or up-to-date.

I'll willing to help you to properly document and update this repository, as well to help people that want to use this. 

Let me know what you about it.
