semantically fixed docstrings