minor comment updates ; add README.md