cleanup: Fixing some grammar and wording.

[larrydewey]

This adds some cleanup for the existing documentation, adds some language specifiers for code blocks, as well as some fixes for minor spelling issues.