Edit documentation. 

Reformat and edit for clarity and look. Used more monospace-type formatting for code snippets and the like, and made things easier to understand.