Trim up the readme

heavily and run ~~it~~ through Docco as part of the build process.