Format changes

I put the doc into a more idiomatic and easier to read form for markdown. There are a couple of very minor content changes, but I'm saving more substantive edits for another pull request. This is just formatting.