cleanup readme situation. part of #481
Merge pull request #502 from jdegoes/ready/481

cleanup readme situation. part of #481