update the readme.md to *hopefully* make sense