Better docs

* Restructure sections a bit
* Enrich examples and fix slight issues in them