Add docs for the new callsFake behavior

lucasfcosta · lucasfcosta · commit bdd3f821a905 · 2017-03-11T13:41:31.000-03:00
diff --git a/docs/release-source/release/stubs.md b/docs/release-source/release/stubs.md
@@ -211,6 +211,22 @@ stub.called // false
 
 *Since `sinon@2.0.0`*
 
+#### `stub.callsFake(fakeFunction);`
+Makes the stub call the provided `fakeFunction` when invoked.
+
+```javascript
+var myObj = {};
+myObj.prop = function propFn() {
+    return "foo";
+};
+
+sinon.stub(myObj, prop).callsFake(function fakeFn() {
+    return 'bar';
+});
+
+myObj.prop(); // 'bar'
+```
+
 #### `stub.returns(obj);`
 Makes the stub return the provided value.
 
