README.rdoc in mongoid_follow-0.0.2 vs README.rdoc in mongoid_follow-0.1.0

@@ -1,58 +1,76 @@
-= Follow stuff for Mongoid
+= Follow feature for Rails3 with Mongoid
 
 == Installation
 
 In Gemfile:
-  gem 'mongoid_follow""
+  gem 'mongoid_follow'
 
+== Legend (to ease complications)
+
+  "follower" is a model who follows
+  "followee" is a model who would be followed
+
 == To use
 
-To make mongoid_follow usable you need to include Mongoid::Followee into your document
-Meanwhile, you also need to include Mongoid::Follower in your follower model:
+To make mongoid_follow usable you need to include Mongoid::Followee into your document who would be followed then you also need to include Mongoid::Follower in your follower model:
 
   class User
     include Mongoid::Document
+
     include Mongoid::Followee
     include Mongoid::Follower
   end
 
   class Group
     include Mongoid::Document
+
     include Mongoid::Followee
   end
 
 You can then follow a model using:
 
-  @bonnie = User.new
-  @bonnie.save
+  @bonnie = User.create
+  @clyde = User.create
 
-  current_user.follow(@clyde)
-  current_user.unfollow?(@clyde)
+  @bonnie.follow(@clyde)
+  @bonnie.unfollow(@clyde)
 
-You can also see whether a model is a follower of another model or a model is a followee of another model:
+You can also see whether a model is a follower of another model or if a model is a followee of another model:
 
-    current_user.follower?(@clyde)
-    current_user.followee?(@clyde)
+  @clyde.follower?(@bonnie)
+  @bonnie.followee?(@clyde)
 
-Of course, you can get a list of followers/followees:
+You can also be a follower of other models
 
-    @clyde.followers
-    @bonnie.followees
+  @gang = Group.create
+  @bonnie.follow(@group)
 
-* Any bug or issue, please send me an email: [e-mail]
+  @gang.follower?(@bonnie)
+  @bonnie.follows?(@gang)
 
+* Any bug or issue, please send me an email to [e-mail]
+
+== For development
+
+  gem install 'mongoid'
+  gem install 'bson_ext'
+  gem install 'database_cleaner'
+  gem install 'rspec'
+
+  rake spec/specs/follow_spec_rb
+
 == TODO
 
-* finish up todo's
-* count of followers/followees
-* common followers (or maybe followees)
-* maybe... (un)authorization of who can follow (model)
-* most/least followed/following #FINISHED
+* finish up todo's (list of followers and followees) ==FINISHED
+* count of followers/followees ==FINISHED
+* common followers (or maybe followees) ==FINISHED
 
 == Thanks
 
-Thanks the mongoid_followable for 
+Super thanks:
+to mongoid_followable.
+to Tristan Peralta.
 
 == Copyright
 
 Copyright (c) Alec Guintu. See LICENSE.txt for further details.