improve docstrings

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