Add meaningful documentation to README.md.

README.md now contains usage information and a description of the
design of the library and the conventions that it uses.