fix links and minor formatting
Merge pull request #1652 from rhelmer/doc-formatting

(no bug) fix links and minor formatting