First attempt to write better docs
Feel free to improve them :)