corrections and clarifications to readme