revise docstrings