Suggestions for improved readability of docs

[jkhaui]

Just wanted to contribute something back to this great library. I've cleaned up the docs in some areas so they read better and appear more professional

[crimx]

Thanks a lot. Much appreciated.