add some clarifications to the README
add some TODOs in README and fix a typo