Improve documentation
- Capitalize in the beggining of a sentence
- Capitalize document filenames
- Add missing periods
- Add more markdown formatting where appropriate.
- Add links for URLs and references to documents in the repo
- Remove unnecessary indentation
- Wrap at 80 characters
No changes in the instructions or wording were done is this commit.