DOC: improve documentation

Merged Fabrice Gangler requested to merge 26_DOC into master

Refs: #26 (closed)

Merge request reports