please improve documentation

[gileneusz]

Provided documentation does not show in details how to use it

[David-Desmaisons]

Documentation updated.