better docstrings, few typos fixed, #78