Merge remote-tracking branch 'upstream/master'

# Conflicts:
#	src/v2/guide/events.md
#	src/v2/guide/filters.md
#	src/v2/guide/installation.md
#	src/v2/guide/list.md
#	src/v2/guide/mixins.md
#	src/v2/guide/team.md

Author: phanan

pre-deploy.js

@@ -39,6 +39,7 @@ Promise.all([
     installation
       .replace(/vue_version: .*/, 'vue_version: ' + version)
       .replace(/gz_size:.*/g, `gz_size: "${prodSize}"`)
+      .replace(/\/vue@[\d\.]+\//g, `/vue@${version}/`)
   )
   console.log(`\nSuccessfully updated Vue version and gzip file size.\n`)
 }).catch(err => {

src/v2/api/index.md

@@ -327,6 +327,8 @@ type: api
   var myFilter = Vue.filter('my-filter')
   ```
 
+- **See also:** [Filters](../guide/filters.html)
+
 ### Vue.component( id, [definition] )
 
 - **Arguments:**
@@ -792,11 +794,9 @@ type: api
 
 - **Details:**
 
-  Called when the data changes, before the virtual DOM is re-rendered and patched.
-
-  You can perform further state changes in this hook and they will not trigger additional re-renders.
+  Called when data changes, before the DOM is patched. This is a good place to access the existing DOM before an update, e.g. to remove manually added event listeners.
 
-  **This hook is not called during server-side rendering.**
+  **This hook is not called during server-side rendering, because only the initial render is performed server-side.**
 
 - **See also:** [Lifecycle Diagram](../guide/instance.html#Lifecycle-Diagram)
 

src/v2/examples/tree-view.md

@@ -6,4 +6,4 @@ order: 4
 
 > Ví dụ về hiển thị một danh sách dạng cây đơn giản bằng cách sử dụng component đệ quy.
 
-<iframe width="100%" height="500" src="https://jsfiddle.net/yyx990803/3p0j5sgy/embedded/result,html,js,css" allowfullscreen="allowfullscreen" frameborder="0"></iframe>
+<iframe width="100%" height="500" src="https://jsfiddle.net/chrisvfritz/pnqzspoe/embedded/result,html,js,css" allowfullscreen="allowfullscreen" frameborder="0"></iframe>

src/v2/guide/events.md

@@ -220,14 +220,19 @@ Không như các modifier khác, vốn chỉ dùng được cho các sự kiện
 
 > Từ phiên bản 2.3.0 trở đi
 
-``` html
-<!-- sự kiện scroll sẽ không chặn hành vi scroll mặc định -->
+Vue cũng cung cấp modifier `.passive`, tương ứng với [tùy chọn `passive` cho `addEventListener`](https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener#Parameters).
+
+```html
+<!-- 
+hành vi mặc định của sự kiện scroll (cuộn trang) sẽ xảy ra 
+ngay lập tức, thay vì đợi `onScroll` hoàn tất.
+-->
 <div v-on:scroll.passive="onScroll">...</div>
 ```
 
-Ngoài những modifier kể trên, Vue còn cung cấp thêm modifier `.passive` để cải thiện hiệu năng, nhất là trên nền tảng di động. Ví dụ, khi thực hiện cuộn trang (scroll), trình duyệt sẽ chỉ cuộn sau khi hàm xử lí được hoàn tất, vì trình duyệt không biết sự kiện có gọi `event.preventDefault()` để chặn hành vi mặc định bên trong hàm xử lí hay không. Chúng ta có thể dùng modifier `.passive` để thông báo trước cho trình duyệt biết rằng sự kiện sẽ không chặn hành vi mặc định.
+Modifier `.passive` đặc biệt hữu ích để cải thiện hiệu năng của ứng dụng trên các thiết bị di động.
 
-<p class="tip">Đừng dùng `.passive` và `.prevent` chung với nhau, vì `.passive` không thể chặn sự kiện mặc định.</p>
+<p class="tip">Đừng dùng `.passive` và `.prevent` cùng nhau, vì `.prevent` sẽ không có hiệu lực, và trình duyệt có thể sẽ bật cảnh báo. Nên nhớ rằng `.passive` thông báo cho trình duyệt biết rằng bạn _không muốn_ ngăn chặn hành vi mặc định của sự kiện.</p>
 
 ## Key modifier
 

src/v2/guide/filters.md

@@ -27,7 +27,7 @@ filters: {
 }
 ```
 
-hoặc định nghĩa ở cấp toàn cục:
+hoặc định nghĩa ở cấp toàn cục trước khi khởi tạo một đối tượng Vue:
 
 ``` js
 /** Viết hoa chữ đầu tiên */
@@ -36,6 +36,10 @@ Vue.filter('capitalize', function (value) {
   value = value.toString()
   return value.charAt(0).toUpperCase() + value.slice(1)
 })
+
+new Vue({
+  // ...
+})
 ```
 
 Sau đây là một ví dụ sử dụng filter `capitalize` trên:

src/v2/guide/installation.md

@@ -34,10 +34,18 @@ Chỉ cần tải file thư viện về rồi sử dụng nó trong thẻ script
 
 ### CDN
 
-Nên dùng: [https://cdn.jsdelivr.net/npm/vue](https://cdn.jsdelivr.net/npm/vue), nó sẽ trỏ tới bản mới nhất của Vue trên npm. Bạn có thể xem mã nguồn của package trên npm tại [https://cdn.jsdelivr.net/npm/vue/](https://cdn.jsdelivr.net/npm/vue/).
+Chúng tôi khuyến khích trỏ đến một phiên bản cụ thể mà bạn có thể tự thay đổi nếu cần:
+
+``` html
+<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/vue.js"></script>
+```
+
+Bạn có thể xem mã nguồn của package trên npm tại [https://cdn.jsdelivr.net/npm/vue/](https://cdn.jsdelivr.net/npm/vue/).
 
 Ngoài ra, bạn cũng có thể sử dụng [unpkg](https://unpkg.com/vue) hoặc [cdnjs](https://cdnjs.cloudflare.com/ajax/libs/vue/{{vue_version}}/vue.js) (cdnjs cần nhiều thời gian để đồng bộ nên có thể nó chưa phải phiên bản mới nhất).
 
+Nhớ đọc thêm về [các bản build khác nhau của Vue](#giai-thich-ve-cac-ban-build) và sử dụng bản Vue production khi publish bản production cho trang web hoặc app của bạn, thay `vue.js` bằng `vue.min.js`. Đây là bản nhỏ hơn, được tối ưu về tốc độ. 
+
 ## NPM
 
 Chúng tôi khuyên bạn nên sử dụng NPM khi muốn xây dựng một ứng dụng lớn với Vue. NPM hoạt động rất tốt với các module bundler (các công cụ đóng gói module) như [Webpack](https://webpack.js.org/) hoặc [Browserify](http://browserify.org/). Vue cũng cung cấp công cụ hỗ trợ để viết các [single file component](single-file-components.html).

src/v2/guide/list.md

@@ -331,13 +331,13 @@ Vue.set(vm.userProfile, 'age', 800)
 Bạn cũng có thể dùng phương thức đối tượng (instance method) `vm.$set`, một alias cho phương thức toàn cục `Vue.set`:
 
 ``` js
-vm.$set(this.userProfile, 'age', 800)
+vm.$set(vm.userProfile, 'age', 800)
 ```
 
 Đôi khi bạn cũng muốn thêm vài thuộc tính cùng lúc vào một object có sẵn, sử dụng `Object.assign()` hoặc `_.extend()`. Trong những trường hợp này, nên tạo một object mới với các thuộc tính từ hai object kia. Có nghĩa là thay vì:
 
 ``` js
-Object.assign(this.userProfile, {
+Object.assign(vm.userProfile, {
   age: 800,
   favoriteColor: 'Tím mộng mơ'
 })
@@ -346,7 +346,7 @@ Object.assign(this.userProfile, {
 bạn sẽ thêm thuộc tính reactive mới bằng như sau:
 
 ``` js
-this.userProfile = Object.assign({}, this.userProfile, {
+vm.userProfile = Object.assign({}, vm.userProfile, {
   age: 800,
   favoriteColor: 'Tím mộng mơ'
 })

src/v2/guide/mixins.md

@@ -33,7 +33,36 @@ var component = new Component() // => "Mixin xin chào!"
 
 ## Hợp nhất các tùy chọn
 
-Khi một mixin và component chứa những tùy chọn trùng nhau, những tùy chọn này sẽ được merge (hợp nhất) bằng cách sử dụng các chiến lược thích hợp. Ví dụ, những hàm hook trùng tên với nhau được merge vào trong một mảng để tất cả những hàm hook đó đều được gọi. Thêm vào đó, những hook trong mixin sẽ được gọi **trước** những hook trong component:
+Khi một mixin và component chứa những tùy chọn trùng nhau, những tùy chọn này sẽ được merge (hợp nhất) bằng cách sử dụng các chiến lược thích hợp. 
+
+Ví dụ, những object `data` sẽ được merge sâu một cấp (shallow merge), và khi có xung đột thì data của component sẽ được ưu tiên.
+
+``` js
+var mixin = {
+  data: function () {
+    return {
+      message: 'chào anh',
+      foo: 'abc'
+    }
+  }
+}
+
+new Vue({
+  mixins: [mixin],
+  data: function () {
+    return {
+      message: 'chào chị',
+      bar: 'def'
+    }
+  },
+  created: function () {
+    console.log(this.$data)
+    // => { message: "chào chị", foo: "abc", bar: "def" }
+  }
+})
+```
+
+Những hàm hook trùng tên với nhau được merge vào trong một mảng để tất cả những hàm hook đó đều được gọi. Thêm vào đó, những hook trong mixin sẽ được gọi **trước** những hook trong component:
 
 ``` js
 var mixin = {

src/v2/guide/team.md

@@ -197,6 +197,7 @@ order: 803
     'Annecy, Pháp': [45.899247, 6.129384],
     'Alicante, Tây Ban Nha' : [38.346543, -0.483838],
     'Bangalore, Ấn Độ': [12.971599, 77.594563],
+    'Bắc Kinh, Trung Quốc': [39.904200, 116.407396],
     'Bordeaux, Pháp': [44.837789, -0.579180],
     'Bucharest, Romania': [44.426767, 26.102538],
     'Chengdu, Trung Quốc': [30.572815, 104.066801],
@@ -600,7 +601,7 @@ order: 803
     {
       name: 'kingwl',
       title: 'New Bee',
-      city: 'Beijin, China',
+      city: 'Bắc Kinh, Trung Quốc',
       languages: ['zh'],
       work: {
         role: 'Software Development Engineer',