Fix sinonjs#1432: add details around expectations.withArgs behavior t…

…o docs (sinonjs#1501)
franck-romano · Oct 1, 2019 · 1f2a7a5 · 1f2a7a5
1 parent d264cb5
commit 1f2a7a5
Showing 1 changed file with 4 additions and 0 deletions.
diff --git a/docs/release-source/release/mocks.md b/docs/release-source/release/mocks.md
@@ -146,11 +146,15 @@ Expect the method to be called exactly `number` times.
 
 Expect the method to be called with the provided arguments and possibly others.
 
+An `expectation` instance only holds onto a single set of arguments specified with `withArgs`. Subsequent calls will overwrite the previously-specified set of arguments (even if they are different), so it is generally not intended that this method be invoked more than once per test case.
+
 
 #### `expectation.withExactArgs(arg1, arg2, ...);`
 
 Expect the method to be called with the provided arguments and no others.
 
+An `expectation` instance only holds onto a single set of arguments specified with `withExactArgs`. Subsequent calls will overwrite the previously-specified set of arguments (even if they are different), so it is generally not intended that this method be invoked more than once per test case.
+
 
 #### `expectation.on(obj);`