Fix doc NuGet references, markdown update

- fixes SharePoint#2070
- update doc references to NuGet packages
- clean up markdown formatting
- improve doc readability score

Author: andrewconnell