more clarity in readme
shuffling title and badge order
remove verbose failures from examples
make subtitles more readable
integrates example responses as comments
subtitles slightly smaller
Merge pull request #5 from tonyta/more-readme-tweaks

More readme tweaks