Updated README.md

Provided examples with Symbol and String based keys.  Added details of how to enable indifferent matching.

Author: sa73917

README.md

@@ -1,25 +1,20 @@
 # jsonapi-rspec
-
 RSpec matchers for [JSON API](http://jsonapi.org).
 
 ## Resources
-
 * Chat: [gitter](http://gitter.im/jsonapi-rb)
 * Twitter: [@jsonapirb](http://twitter.com/jsonapirb)
 
 ## Installation
-
 Add the following to your application's Gemfile:
 ```ruby
 gem 'jsonapi-rspec'
 ```
-And then execute:
+then execute:
 ```
 $ bundle
 ```
-
-Add to your `spec/spec_helpers.rb`:
-
+and add `jsonapi/rspec` to your `spec/spec_helpers.rb`:
 ```ruby
 # spec/spec_helpers.rb
 require 'jsonapi/rspec'
@@ -29,17 +24,17 @@ RSpec.configure do |config|
   config.include JSONAPI::RSpec
 end
 ```
-
 ## Usage and documentation
 
-Available matchers:
+### Available matchers:
 
 * `expect(document['data']).to have_id('12')`
 * `expect(document['data']).to have_type('users')`
 * `expect(document['data']).to have_jsonapi_attributes(:name, :email)`
 * `expect(document['data']).to have_jsonapi_attributes(:name, :email, :country).exactly`
 * `expect(document['data']).to have_attribute(:name).with_value('Lucas')`
 * `expect(document['data']).to have_relationships(:posts, :comments)`
+* `expect(document['data']).to have_relationship(:posts).with_data({ id: '1', type: 'posts' })`
 * `expect(document['data']).to have_relationship(:posts).with_data([{ 'id' => '1', 'type' => 'posts' }])`
 * `expect(document['data']['relationships']['posts']).to have_links(:self, :related)`
 * `expect(document['data']).to have_link(:self).with_value('http://api.example.com/users/12')`
@@ -48,10 +43,20 @@ Available matchers:
 * `expect(document).to have_jsonapi_object`
 * `expect(document).to have_jsonapi_object('version' => '1.0')`
 
-## Advanced examples
+### Indifferent Matching
+```ruby
+# spec/spec_helpers.rb
+require 'jsonapi/rspec'
 
-Checking for an included resource:
+RSpec.configure do |config|
+  # ...
+  config.allow_symbolized_jsonapi = true
+end
+```
+The configuration above allows the RSpec matchers to work with a symbolized jsonapi source document.
 
+## Advanced examples
+Checking for an included resource:
 ```ruby
 expect(response_body['included'])
   .to include(have_type('posts').and have_id('1'))
@@ -67,4 +72,4 @@ contributors are expected to adhere to the
 
 ## License
 
-jsonapi-rspec is released under the [MIT License](http://www.opensource.org/licenses/MIT).
+jsonapi-rspec is released under the [MIT License](http://www.opensource.org/licenses/MIT).