Add note on arrayDelete with array vs. path

Fixes #2427.
Polymer · Sep 10, 2015 · d2b71a5 · d2b71a5
1 parent 83cce66
commit d2b71a5
Showing 1 changed file with 8 additions and 1 deletion.
diff --git a/src/standard/utils.html b/src/standard/utils.html
@@ -199,9 +199,16 @@
 
     /**
      * Removes an item from an array, if it exists.
+     * 
+     * If the array is specified by path, a change notification is 
+     * generated, so that observers, data bindings and computed
+     * properties watching that path can update. 
+     * 
+     * If the array is passed directly, **no change
+     * notification is generated**.
      *
      * @method arrayDelete
-     * @param {String|Array} path Path torray from which to remove the item
+     * @param {String|Array} path Path to array from which to remove the item
      *   (or the array itself).
      * @param {any} item Item to remove.
      * @return {Array} Array containing item removed.