fixed some typos and added more info in docstrings