docs: Fix typos and styling

Fixes typos and grammar. Standardizes paragraph padding,
punctuation usage, code formatting, and multi-line code language
for syntax highlighting. Formats references to other files as links.

Author: Elliot Jones