update to README.md, minor comment updates