Outline, typos, wording

[paulHempel]

Added an outline, as I would be otherwise scrolling through the docs all day.

Fixed some typos on the way and changed some words to improve readability (hopefully)

[cgrand]

Thanks. If only the outline was an automatic feature.