edit array extension methods

yyx990803 · yyx990803 · commit f84981264e96 · 2016-03-30T12:34:28.000-04:00
diff --git a/src/api/index.md b/src/api/index.md
@@ -2186,34 +2186,36 @@ type: api
 
 ## Array Extension Methods
 
+Vue.js extends `Array.prototype` with two additional methods that makes it easier to perform some common Array operations while ensuring reactive updates are properly triggered.
+
 ### array.$set(index, value)
 
 - **Arguments**
   - `{Number} index`
   - `{*} value`
 
 - **Usage**
-  
+
   Set an element in the array to a value by index and trigger view updates.
 
   ``` js
-    vm.animals.$set(0, { name: 'Aardvark' })
+  vm.animals.$set(0, { name: 'Aardvark' })
   ```
 
-- **See also:** [Mutation Methods](/guide/list.html#Mutation-Methods)
+- **See also:** [Array Detection Caveats](/guide/list.html#Caveats)
 
 ### array.$remove(reference)
 
 - **Arguments**
   - `{Reference} reference`
 
 - **Usage**
-  
-  Remove an element from an array by reference and trigger view updates.
+
+  Remove an element from an array by reference and trigger view updates. This is a sugar method for first searching for the element in the array, and then if found, calling `array.splice(index, 1)`.
 
   ``` js
-    var aardvark = vm.animals[0]
-    vm.animals.$remove(aardvark)
+  var aardvark = vm.animals[0]
+  vm.animals.$remove(aardvark)
   ```
 
-- **See also:** [Mutation Methods](/guide/list.html#Mutation-Methods)
+- **See also:** [Mutation Methods](/guide/list.html#Mutation-Methods)
