first round of edits

please review @kbastani @jexp 

I tried not to change it too much...
With asciidoc we try to keep one sentence per line, which makes it easier to version and see changes. Aciidoctor pulls everything together into one paragraph that's not separated by a newline.