Improves documentation around stubProperty

README.md

@@ -209,12 +209,14 @@ SomeStruct aStruct = {...};
 How do you stub a property so that KVO works?
 ---------------------------------------------
 
-Use `stubProperty(instance, property, value)`. For example:
+Use `stubProperty(mock, property, stubbedValue)`. For example, say you have a mock object named `mockEmployee`. It has a property `firstName`. You want to stub it to return the value "FIRST-NAME":
 
 ```obj-c
-stubProperty(mockEmployee, firstName, @"fake-firstname");
+stubProperty(mockEmployee, firstName, @"FIRST-NAME");
 ```
 
+This stubs the `firstName` property, `valueForKey:` and `valueForKeyPath:`.
+
 
 Argument matchers
 -----------------

Source/OCMockito/Core/OCMockito.h

@@ -173,11 +173,11 @@ FOUNDATION_EXPORT MKTOngoingStubbing *MKTGivenVoidWithLocation(id testCase, cons
 #endif
 
 
-#define MKTStubProperty(instance, property, value)                          \
-    do {                                                                    \
-        [MKTGiven([instance property]) willReturn:value];                   \
-        [MKTGiven([instance valueForKey:@#property]) willReturn:value];     \
-        [MKTGiven([instance valueForKeyPath:@#property]) willReturn:value]; \
+#define MKTStubProperty(mock, property, stubbedValue)                          \
+    do {                                                                       \
+        [MKTGiven([mock property]) willReturn:stubbedValue];                   \
+        [MKTGiven([mock valueForKey:@#property]) willReturn:stubbedValue];     \
+        [MKTGiven([mock valueForKeyPath:@#property]) willReturn:stubbedValue]; \
     } while(0)
 
 #ifndef MKT_DISABLE_SHORT_SYNTAX
@@ -188,7 +188,7 @@ FOUNDATION_EXPORT MKTOngoingStubbing *MKTGivenVoidWithLocation(id testCase, cons
  * In the event of a name clash, <code>#define MKT_DISABLE_SHORT_SYNTAX</code> and use the synonym
  * MKTStubProperty instead.
  */
-#define stubProperty(instance, property, value) MKTStubProperty(instance, property, value)
+#define stubProperty(mock, property, stubbedValue) MKTStubProperty(mock, property, stubbedValue)
 #endif