some tweaks in docstrings