minor clarifications to docstrings and wording