README.md in intercom-0.1.17 vs README.md in intercom-0.1.19

@@ -1,10 +1,10 @@
 # intercom-ruby
 
 Ruby bindings for the Intercom API (https://api.intercom.io).
 
-[API Documentation](https://api.intercom.io)
+[API Documentation](https://api.intercom.io/docs)
 
 [Gem Documentation](http://rubydoc.info/github/intercom/intercom-ruby/master/frames)
 
 For generating Intercom javascript script tags for Rails, please see https://github.com/intercom/intercom-rails
 
@@ -18,12 +18,14 @@
 
 ## Basic Usage
 
 ### Configure your access credentials
 
-    Intercom.app_id = "my_app_iddd"
-    Intercom.api_key = "my-super-crazy-api-key"
+```ruby
+Intercom.app_id = "my_app_id"
+Intercom.api_key = "my-super-crazy-api-key"
+```
 
 ### Resources
 
 The API supports:
 
@@ -33,46 +35,57 @@
     POST https://api.intercom.io/v1/users/notes
 
 ### Examples
 
 #### Users
-    user = Intercom::User.find_by_email("[e-mail]")
-    user.custom_data["average_monthly_spend"] = 1234.56
-    user.save
-    user = Intercom::User.find_by_user_id("[e-mail]")
-    user = Intercom::User.create(:email => "[e-mail]", :name => "Bob Smith")
-    user = Intercom::User.new(params)
-    user.save
-    Intercom::User.all.count
-    Intercom::User.all.each {|user| puts %Q(#{user.email} - #{user.custom_data["average_monthly_spend"]}) }
-    Intercom::User.all.map {|user| user.email }
 
+```ruby
+user = Intercom::User.find_by_email("[e-mail]")
+user.custom_data["average_monthly_spend"] = 1234.56
+user.save
+user = Intercom::User.find_by_user_id("[e-mail]")
+user = Intercom::User.create(:email => "[e-mail]", :name => "Bob Smith")
+user = Intercom::User.new(params)
+user.save
+Intercom::User.all.count
+Intercom::User.all.each {|user| puts %Q(#{user.email} - #{user.custom_data["average_monthly_spend"]}) }
+Intercom::User.all.map {|user| user.email }
+```
+
 #### Companies
-    user = Intercom::User.find_by_email("[e-mail]")
-    user.company = {:id => 6, :name => "Intercom"}
-    user.companies = [{:id => 6, :name => "Intercom"}, {:id => 9, :name => "Test Company"}]
+```ruby
+user = Intercom::User.find_by_email("[e-mail]")
+user.company = {:id => 6, :name => "Intercom"}
+user.companies = [{:id => 6, :name => "Intercom"}, {:id => 9, :name => "Test Company"}]
+```
 
 You can also pass custom data within a company:
 
-    user.company = {:id => 6, :name => "Intercom", :referral_source => "Google"}
+```ruby
+user.company = {:id => 6, :name => "Intercom", :referral_source => "Google"}
+```
 
 #### Message Threads
+```ruby
+Intercom::MessageThread.create(:email => "[e-mail]", :body => "Example message from [e-mail] to your application on Intercom.")
+Intercom::MessageThread.find(:email => "[e-mail]", :thread_id => 123)
+Intercom::MessageThread.find_all(:email => "[e-mail]")
+Intercom::MessageThread.mark_as_read(:email => "[e-mail]", :thread_id => 123)
+```
 
-    Intercom::MessageThread.create(:email => "[e-mail]", :body => "Example message from [e-mail] to your application on Intercom.")
-    Intercom::MessageThread.find(:email => "[e-mail]", :thread_id => 123)
-    Intercom::MessageThread.find_all(:email => "[e-mail]")
-    Intercom::MessageThread.mark_as_read(:email => "[e-mail]", :thread_id => 123)
-
 #### Impressions
+```ruby
+Intercom::Impression.create(:email => "[e-mail]", :location => "/path/in/my/app", :user_ip => "1.2.3.4", :user_agent => "my-savage-iphone-app-0.1"
+```
 
-    Intercom::Impression.create(:email => "[e-mail]", :location => "/path/in/my/app", :user_ip => "1.2.3.4", :user_agent => "my-savage-iphone-app-0.1"
-
 #### Notes
+```ruby
+Intercom::Note.create(:email => "[e-mail]", :body => "This is the text of the note")
+```
 
-    Intercom::Note.create(:email => "[e-mail]", :body => "This is the text of the note")
-
 ### Errors
-
-    Intercom::AuthenticationError
-    Intercom::ServerError
-    Intercom::ServiceUnavailableError
-    Intercom::ResourceNotFound
+```ruby
+Intercom::AuthenticationError
+Intercom::ServerError
+Intercom::ServiceUnavailableError
+Intercom::ResourceNotFound
+```