corrections and clarifications to readme.md