Fix links & formatting

- fix markdown formatting issues
- improve doc readability
- updated links
- fixes SharePoint#2227

Author: andrewconnell