This reverts commit 8cfe2c549dc350bb7650c1b0321813c5f17ce2d8.
* misc edits in /docs; mostly style, grammar, consistency * changes per reviewers requests * removed .md ext from links in 2 files per request