Improved readme and documentation

Cleared up a couple mistakes and ambiguities in the documentation.