Documentation improves:
- documentation updates v1
- Fixed typos
- Minor copyediting changes and checking in new file
- Fixed formatting
- Fixed broken link