more tweaks

Author: yyx990803

source/api/directives.md

@@ -61,7 +61,7 @@ Alternatively, you can bind the directive directly to an Object. The keys of the
 
 Internally, {{ Mustache }} interpolations inside attributes are compiled into computed `v-attr` directives.
 
-Starting in 0.12.8, when used on input elements' `value` attribute, `v-attr` also sets the corresponding `value` property on the element. For example, `<input value="{% raw %}{{val}}{% endraw %}">` will not only update the attribute, but also set the underlying JavaScript property.
+Starting in 0.12.9, when used on input elements' `value` attribute, `v-attr` now updates the corresponding `value` property on the element instead of the attribute. For example, `<input value="{% raw %}{{val}}{% endraw %}">` will update the underlying JavaScript property instead of the attribute.
 
 <p class="tip">You should use `v-attr` instead of mustache binding when setting the `src` attribute on `<img>` elements. Your templates are parsed by the browser before being compiled by Vue.js, so the mustache binding will cause a 404 when the browser tries to fetch it as the image's URL.</p>
 
@@ -199,7 +199,7 @@ For detailed examples, see [Displaying a List](/guide/list.html).
 
 ## Literal Directives
 
-> Literal directives treat their attribute value as a plain string; they do not attempt to bind themselves to anything. All they do is executing the `bind()` function with the string value once. Literal directives accept mustache expressions inside their value, but these expressions will be evaluated only once on first compile and do not react to data changes.
+> Literal directives treat their attribute value as a plain string; they do not attempt to bind themselves to anything. All they do is executing the `bind()` function once. Literal directives can also accept mustache expressions inside their value - please refer to [Dynamic Literal](/guide/custom-directive.html#Dynamic_Literal) for more details.
 
 ### v-transition
 

source/api/global-api.md

@@ -134,7 +134,7 @@ Register or retrieve a global component. For more details see [Component System]
 - **id** `String`
 - **definition** `Object` *optional*
 
-Register or retrieve a global JavaScript transition effect definition. For more details see the guide for [JavaScript Transitions](/guide/transitions.html#JavaScript_Functions).
+Register or retrieve a global JavaScript transition effect definition. For more details see the guide for [JavaScript Transitions](/guide/transitions.html#JavaScript_Only_Transitions).
 
 ### Vue.partial( id, [partial] )
 

source/api/instance-methods.md

@@ -78,7 +78,7 @@ Set a data value on the Vue instance given a valid keypath. If the path doesn't
 - **keypath** `String`
 - **value** `*`
 
-Add a root level property to the Vue instance (and also its `$data`). Due to the limitations of ES5, Vue cannot detect properties directly added to or deleted from an Object, so use this method and `vm.$delete` when you need to do so. Additionally, all observed objects are augmented with these two methods too.
+Add a root level property to the Vue instance (and also its `$data`). Due to the limitations of ES5, Vue cannot detect properties directly added to or deleted from an Object, so use this method and `vm.$delete` when you need to do so. Make sure to use this only when necessary, because this method forces a dirty check of all watchers in the current vm.
 
 ### vm.$delete( keypath )
 
@@ -214,9 +214,9 @@ If no argument is provided, the template will be created as an out-of-document e
 
 ### vm.$destroy( [remove] )
 
-- **remove** `Boolean` *optional*
+- **remove** `Boolean` *optional* (Default: `false`)
 
-Completely destroy a vm. Clean up its connections with other existing vms, unbind all its directives and remove its `$el` from the DOM. Also, all `$on` and `$watch` listeners will be automatically removed.
+Completely destroy a vm. Clean up its connections with other existing vms, unbind all its directives and optionally remove its `$el` from the DOM. Also, all `$on` and `$watch` listeners will be automatically removed.
 
 ### vm.$compile( element )
 

source/api/instance-properties.md

@@ -8,7 +8,7 @@ order: 3
 - **Type:** `HTMLElement`
 - **Read only**
 
-The DOM element that the Vue instance is managing.
+The DOM element that the Vue instance is managing. Note that for [Fragment Instances](/guide/best-practices.html#Fragment_Instance), `vm.$el` will return an anchor node that indicates the starting position of the fragment.
 
 ### vm.$data