Refactor documentation out of code.

Documentation was duplicated between code and README.md. Now it all
lives in one place, the README