update docstrings, docs, and some argument names