README.md in intercom-0.0.1 vs README.md in intercom-0.0.2

@@ -1,16 +1,35 @@
-## Usage
+Ruby bindings for the Intercom API (https://api.intercom.io). See http://docs.intercom.io/api for more details
 
+## Basic Usage
+
+### Configure your access credentials
+
 ```
 Intercom.app_id = "my_app_id"
 Intercom.secret_key = "my-super-crazy-secret"
+```
 
-user = Intercom::User.new(
-  :email => '[e-mail]'
-  ...
-)
+### Resources
+
+All methods in this API operate in the context of a single user. Users are identified by either an '''email''' address or a '''user_id'''.
+One of these is required as input to every operation.
+
+#### Users
+
+user = Intercom::User.find(:email => "[e-mail]")
+user = Intercom::User.create(params)
+user = Intercom::User.new(params)
 user.save
 
-...
+#### Messages
 
-user = Intercom::User.find(:email => '[e-mail]')
-```
\ No newline at end of file
+Intercom::Message.create
+Intercom::Message.find
+Intercom::Message.find_all
+Intercom::Message.mark_as_read
+
+#### Impressions
+
+Intercom::Impression.create
+
+### Errors