Improvs to docstrings, parameter names, logging