Cleaning up docs.

fixed typos and made things easier to understand.