Improve documentation

Merged Samuel GAIST requested to merge improve_documentation into 1.6.x

Merge request reports