improves documentation in the code

Signed-off-by: Jochen Maes <jochen@sejo-it.be>