More document update / harmonization

* take into account some of Sven's advices
* rephrase motivations