improve docstrings

Signed-off-by: Moritz Ulrich <moritz@tarn-vedra.de>