more doc typos
better pharasings
pep8