rework docstrings