README.rdoc in whatser-0.3.2 vs README.rdoc in whatser-0.4.0

@@ -7,10 +7,11 @@
 * read/write API access
 * OAuth 2 authentication (using oauth2)
 * network connectivity (using httparty)
 * simple DSL for API resource classes (spots, media, reviews, check ins, etc.)
 * user spot collection management
+* check-in aggregation
 * social network integration (facebook, twitter, foursquare, gowalla)
 * photo uploads
 
 == Usage
 
@@ -263,9 +264,23 @@
     Whatser.client.data_sources.for_users( :user_id => [101,23], :page => 1, :per_page => 10 )
     m = Whatser.client.data_sources.find( 1 )
     redirect_to m.subscription_url(:display => 'touch')
 
     <Whatser::DataSource @review_count=405, @poi_count=0, @price=0.0, @collection_count=0, @name="Rough Guides - Barcelona", @media_count=0, @id=9, @users=[{"name": "premium user", "id": 33}]>
+
+
+=== Comments
+
+A comment is just a short user note that can be associated with other resources. At the moment, you can comment on a POI, Media, or an Activity Feed. Users can also delete their own comments.
+
+    Whatser.client.comments.poi( poi_id, :page => 1, :per_page => 10 )
+    Whatser.client.comments.media( media_id, :page => 1, :per_page => 10 )
+    Whatser.client.comments.create( 'activity_feed', feed_id, 'This is a comment. Interesting activity!' )
+    Whatser.client.comments.create( 'media', media_id, 'This is a comment on a media. Stunning photo!' )
+    m = Whatser.client.comments.create( 'poi', spot_id, 'This is a comment on a spot. Nice spot!' )
+    m.delete
+
+    <Whatser::Comment @body="This is a comment.", @id=101, @user_id=101, @activity_feed_id=null, @user_avatar="http://example.com/images/thumb/4394.jpg", @subject_id=33, @user_name='Whaster User', @created_at="2010-12-24T16:31:38Z", @subject_type='poi', @subject_name="Some Spot">
 
 
 === Activity Feeds
 
 User activity is recorded by the API, for example when a user adds or tags a POI, befriends another user, or uploads a photo. This activity is recorded in a user's activity feed, a collection of short messages detailing that user's activity. You can view feeds either by user, by spot, or globally.