slight comment grammar and spelling changes
a few more cleanups of docstrings