0.10.3

Author: yyx990803

perf/todomvc-benchmark/todomvc/vue/bower_components/vue/vue.min.js

@@ -110,4 +110,4 @@ Remove the vm's `$el` from the DOM.
 
 ### vm.$destroy()
 
-Completely destroy a vm. Clean up its connections with other existing vms, unbind all its directives and remove its `$el` from the DOM.
+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.

source/api/instance-methods.md

@@ -166,34 +166,36 @@ A hash of HTML attributes to be set on `vm.$el`.
 All lifecycle hooks have their `this` context bound to the ViewModel instance they belong to. For `'attached'`, `'detached'`, `'beforeDestroy'`, `'afterDestroy'`, the ViewModel instance will also emit events in the form of `'hook:eventName'`.
 
 ### created
-  
+
 - **Type:** `Function`
 
-Called synchronously before the compilation starts. Can be used to attach additional data to be observed on the ViewModel.
+Called synchronously before the compilation starts. At this stage, instance properties like `$el`, `$data` are available, but the DOM is in a pre-compile state, and the data has not been observed yet. Usually the created hook is used to attach additional initial states to the ViewModel. Any non-function properties attached to the ViewModel in the created hook will be copied to the data object and observed later.
+
+If you use `$watch` in the created hook, the callback will also be called when the data is freshly observed. If you want to watch for changes only, attach the watcher in the ready hook.
 
 ### ready
 
 - **Type:** `Function`
 
-Called synchronously after the compilation has ended and the ViewModel instance is ready.
+Called synchronously after the compilation has ended and the ViewModel instance is ready. At this stage, the DOM is fully compiled and the data has been observed, so changing existing data properties will trigger View updates. Additional properties attached to the ViewModel or the data object in the ready hook will **not** be observed.
 
 ### attached
 
 - **Type:** `Function`
 
-Called when `vm.$el` is attached to DOM by a VueJS directive. Direct manipulation of `vm.$el` will **not** trigger this hook.
+Called when `vm.$el` is attached to DOM by a directive or a VM instance method such as `$appendTo()`. Direct manipulation of `vm.$el` will **not** trigger this hook.
 
 ### detached
 
 - **Type:** `Function`
 
-Called when `vm.$el` is removed from the DOM by a VueJS directive. Direct manipulation of `vm.$el` will **not** trigger this hook.
+Called when `vm.$el` is removed from the DOM by a directive or a VM instance method. Direct manipulation of `vm.$el` will **not** trigger this hook.
 
 ### beforeDestroy
 
 - **Type:** `Function`
 
-Called before a ViewModel is destroyed.
+Called before a ViewModel is destroyed. At this stage, the data is still observed, and all bindings and directive instances are still in effect. All child VMs of the current instance are also still active. This hook is mostly used internally but you can use it to clean up things you set up in the created or ready hook. There's no need to turn off `$on` and `$watch` listeners in here because all of them will be automatically turned off during `$destroy`.
 
 ### afterDestroy
 

source/api/instantiation-options.md

@@ -1,10 +1,10 @@
 title: Installation
 type: guide
 order: 1
-vue_version: 0.10.2
-dev_size: 118.21
-min_size: 39.55
-gz_size: 13.43
+vue_version: 0.10.3
+dev_size: 119.38
+min_size: 39.90
+gz_size: 13.59
 ---
 
 > **Compatibility Note:** Vue.js does not support IE8 and below.
@@ -17,7 +17,7 @@ Simply download and include with a script tag. `Vue` will be registered as a glo
 
 <a class="button" href="https://raw.github.com/yyx990803/vue/v{{vue_version}}/dist/vue.min.js" download>Production Version</a><br><span class="light">{{min_size}}kb minified / {{gz_size}}kb gzipped</span>
 
-Also available on [cdnjs](//cdnjs.cloudflare.com/ajax/libs/vue/{{vue_version}}/vue.min.js) (takes 4 hours to sync so the latest version might not be available yet).
+Also available on [cdnjs](//cdnjs.cloudflare.com/ajax/libs/vue/{{vue_version}}/vue.min.js) (takes some time to sync so the latest version might not be available yet).
 
 ## Component
 

source/guide/installation.md

@@ -1,3 +1,3 @@
 google_analytics: UA-46852172-1
 root_domain: vuejs.org
-vue_version: 0.10.2
+vue_version: 0.10.3