Review README files
Merge pull request #243 from mbabker/docs

Review README files