add pitfall about array mutation. Closes #1393

1 files changed, 4 insertions, 0 deletions

diff --git a/intro.md b/intro.md
index 2470954..dc4b29c 100644
--- a/intro.md
+++ b/intro.md
@@ -206,6 +206,10 @@ As of version 3.0, you can call any Async callback with `false` as the `error` a
         },
 ```
 
+### Mutating collections
+
+If you pass an array to a collection method (such as `each`, `mapLimit`, or `filterSeries`), and then attempt to `push`, `pop`, or `splice` additional items on to the array, this could lead to unexpected or undefined behavior.  Async will iterate until the original `length` of the array is met, and the indexes of items `pop()`ed or `splice()`d could already have been processed. Therefore, it is not recommended to modify the array after Async has begun iterating over it.  If you do need to `push`, `pop`, or `splice`, use a `queue` instead.
+
 
 ## Download