Housekeeping.

- Updating the .gif to match the blog post.
- Tidying some language.
- Linking to the blog.

CONTRIBUTING.md

@@ -1,6 +1,6 @@
 # Contributing to Swagger::Diff
 
-We welcome Pull Requests from everyone!
+We welcome pull requests from everyone!
 
 ## Getting Started
 
@@ -12,12 +12,12 @@ We welcome Pull Requests from everyone!
 6. Make sure the test suite, including your new tests, passes (`rake`)
 7. Commit your changes (`git commit -am 'Add some feature'`)
 8. Push to the branch (`git push origin my-new-feature`)
-9. Create a new Pull Request
+9. Create a new pull request
 10. If the Travis build fails, address any issues
 
 ## Tips
 
-- All Pull Requests must include test coverage. If you’re not sure how to test
+- All pull requests must include test coverage. If you’re not sure how to test
   your changes, feel free to ask for help.
 - Contributions must conform to the
   [Ruby Style Guide](https://github.com/bbatsov/ruby-style-guide).

README.md

@@ -27,6 +27,8 @@ Specifications are considered backwards compatible if:
 - all response attributes in the old specification have the same type in the new
   one
 
+Read more on the [Civis Analytics blog](https://civisanalytics.com/blog/engineering/2015/10/02/using-swagger-to-detect-breaking-api-changes/).
+
 ## Installation
 
 Add this line to your application's Gemfile: