Add README.md

Ready to merge to upstream template
Update various files; ready to merge to upstream
Merge pull request #1 from yunlhan/master

Thanks @yunlhan for adding in comments and the Readme!!