Refactor of documentation.

Made a pass fixing:
 - typos
 - formatting
 - gramatical errors.

Did not change the meaning of the content.