README.md in popular-0.5.0 vs README.md in popular-0.5.1

- old
+ new
@@ -43,16 +43,23 @@
 
 @sam = User.create name: "Samuel"
 @jackson = User.create name: "Jackson"
 
 # Adding and removing friends
-@sam.friends_with? @jackson   #=> false
-@sam.friends.length           #=> 0
+@sam.friends_with? @jackson         #=> false
+@sam.friended_by? @jackson          #=> false
+
 @sam.befriend @jackson
-@sam.friends_with? @jackson   #=> true
-@sam.friends.length           #=> 1
+@sam.friends_with? @jackson         #=> true
+
 @sam.unfriend @jackson
-@sam.friends_with? @jackson   #=> false
+@sam.friends_with? @jackson         #=> false
+
+@jackson.befriend @sam
+@sam.friended_by? @jackson          #=> true
+
+@sam.befriend @jackson
+@sam.mutual_friends_with? @jackson  #=> true
 ```
 
 ### Callbacks
 
 Popular provides callbacks that are fired around friendship creation. Available callbacks are: