improve docstrings

Signed-off-by: Jochen Maes <jochen@sejo-it.be>
Merge pull request #4 from sejo/1.3

improve docstrings