add clarifications to the README.md