Update doc with more guidance

- added guidance on changing file name
- improved doc readability
- fixed markdown formatting errors
- closes SharePoint#2087

Author: andrewconnell