Merge pull request #2428 from Polymer/arthurevans-patch-1

Add note on arrayDelete with array vs. path

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.