Improve documentation

* add images
* add link to API doc
* change order