Readme doc updates

A variety of updates to the README. Two main goals with these updates:

- Be consistent in formatting
- Be consistent in using RSpec 3 syntax
Not to my knowledge. Relish uses https://github.com/rspec/rspec-rails/blob/master/features/README.md