update docstring, better names