Updating documentation and fixing typos

[jonathandietz]

These are all small changes and don't effect how code is executed.

[jmetzmeier]

:shipit: