Backport pull request #1117

A variety of updates to the README. Two main goals with these updates:

Be consistent in formatting
Be consistent in using RSpec 3 syntax