updated the rest of the README.md to the new semantics