From c700c6746fd6c5af2142ae80640d2d7ae331029c Mon Sep 17 00:00:00 2001
From: Ben Hong <ben@bencodezen.io>
Date: Tue, 14 Jul 2020 23:31:19 -0400
Subject: [PATCH 1/9] docs (#149): add attribute coercion section to migration
 guide

---
 src/.vuepress/config.js                   |   3 +-
 src/guide/migration/attribute-coercion.md | 134 ++++++++++++++++++++++
 2 files changed, 136 insertions(+), 1 deletion(-)
 create mode 100644 src/guide/migration/attribute-coercion.md

diff --git a/src/.vuepress/config.js b/src/.vuepress/config.js
index 2a31451bcd..7a243ff052 100644
--- a/src/.vuepress/config.js
+++ b/src/.vuepress/config.js
@@ -100,7 +100,8 @@ const sidebar = {
         'migration/fragments',
         'migration/render-function-api',
         'migration/slots-unification',
-        'migration/keycode-modifiers'
+        'migration/keycode-modifiers',
+        'migration/attribute-coercion'
       ]
     },
     {
diff --git a/src/guide/migration/attribute-coercion.md b/src/guide/migration/attribute-coercion.md
new file mode 100644
index 0000000000..82b1f522ad
--- /dev/null
+++ b/src/guide/migration/attribute-coercion.md
@@ -0,0 +1,134 @@
+# Attribute Coercion Behavior
+
+::: info Info
+This is a low-level internal API change and does not affect most developers.
+:::
+
+## Overview
+
+Here is a high level summary of the changes:
+
+- Drop the internal concept of enumerated attributes and treat those attributes the same as normal non-boolean attributes
+- **BREAKING**: No longer removes attribute if value is boolean false. Instead, it's set as attr="false" instead. To remove the attribute, use null or undefined.
+
+For more information, read on!
+
+## 2.x Syntax
+
+In 2.x, we had the following strategies for coercing `v-bind` values:
+
+- For some attribute/element pairs, Vue is always using the corresponding IDL attribute (property): [like `value` of `<input>`, `<select>`, `<progress>`, etc](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L11-L18).
+
+- For “[boolean attributes](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L33-L40)” and [xlinks](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L44-L46), Vue removes them if they are “falsy” ([`undefined`, `null` or `false`](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L52-L54)) and adds them otherwise (see [here](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/runtime/modules/attrs.js#L66-L77) and [here](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/runtime/modules/attrs.js#L81-L85)).
+
+- For “[enumerated attributes](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L20)” (currently `contenteditable`, `draggable` and `spellcheck`), Vue tries to [coerce](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L24-L31) them to string (with special treatment for `contenteditable` for now, to fix [vuejs/vue#9397](https://github.com/vuejs/vue/issues/9397)).
+
+- For other attributes, we remove “falsy” values (`undefined`, `null`, or `false`) and set other values as-is (see [here](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/runtime/modules/attrs.js#L92-L113)).
+
+The following table describes how Vue coerce “enumerated attributes” differently with normal non-boolean attributes:
+
+| Binding expr.       | `foo` <sup>normal</sup> | `draggable` <sup>enumerated</sup> |
+| ------------------- | ----------------------- | --------------------------------- |
+| `:attr="null"`      | /                       | `draggable="false"`               |
+| `:attr="undefined"` | /                       | /                                 |
+| `:attr="true"`      | `foo="true"`            | `draggable="true"`                |
+| `:attr="false"`     | /                       | `draggable="false"`               |
+| `:attr="0"`         | `foo="0"`               | `draggable="true"`                |
+| `attr=""`           | `foo=""`                | `draggable="true"`                |
+| `attr="foo"`        | `foo="foo"`             | `draggable="true"`                |
+| `attr`              | `foo=""`                | `draggable="true"`                |
+
+We can see from the table above, current implementation coerces `true` to `'true'` but removes the attribute if it's `false`. This also led to inconsistency and required users to manually coerce boolean values to string in very common use cases like `aria-*` attributes like `aria-selected`, `aria-hidden`, etc.
+
+## 3.x Syntax
+
+We intend to drop this internal concept of “enumerated attributes” and treat them as normal non-boolean HTML attributes.
+
+- This solves the inconsistency between normal non-boolean attributes and “enumerated attributes”
+- It also makes it possible to use values other than `'true'` and `'false'`, or even keywords yet to come, for attributes like `contenteditable`
+
+For non-boolean attributes, Vue will stop removing them if they are `false` and coerce them to `'false'` instead.
+
+- This solves the inconsistency between `true` and `false` and makes outputing `aria-*` attributes easier
+
+The following table describes the new behavior:
+
+| Binding expr.       | `foo` <sup>normal</sup>    | `draggable` <sup>enumerated</sup> |
+| ------------------- | -------------------------- | --------------------------------- |
+| `:attr="null"`      | /                          | / <sup>†</sup>                    |
+| `:attr="undefined"` | /                          | /                                 |
+| `:attr="true"`      | `foo="true"`               | `draggable="true"`                |
+| `:attr="false"`     | `foo="false"` <sup>†</sup> | `draggable="false"`               |
+| `:attr="0"`         | `foo="0"`                  | `draggable="0"` <sup>†</sup>      |
+| `attr=""`           | `foo=""`                   | `draggable=""` <sup>†</sup>       |
+| `attr="foo"`        | `foo="foo"`                | `draggable="foo"` <sup>†</sup>    |
+| `attr`              | `foo=""`                   | `draggable=""` <sup>†</sup>       |
+
+<small>†: changed</small>
+
+Coercion for boolean attributes is left untouched.
+
+## Migration Strategy
+
+### Enumerated attributes
+
+The absence of an enumerated attribute and `attr="false"` may produce different IDL attribute values (which will reflect the actual state), described as follows:
+
+| Absent enumerated attr | IDL attr & value                     |
+| ---------------------- | ------------------------------------ |
+| `contenteditable`      | `contentEditable` &rarr; `'inherit'` |
+| `draggable`            | `draggable` &rarr; `false`           |
+| `spellcheck`           | `spellcheck` &rarr; `true`           |
+
+To keep the old behavior work, and as we will be coercing `false` to `'false'`, in 3.x Vue developers need to make `v-bind` expression resolve to `false` or `'false'` for `contenteditable` and `spellcheck`.
+
+In 2.x, invalid values were coerced to `'true'` for enumerated attributes. This was usually unintended and unlikely to be relied upon on a large scale. In 3.x `true` or `'true'` should be explicitly specified.
+
+### Coercing `false` to `'false'` instead of removing the attribute
+
+In 3.x, `null` or `undefined` should be used to explicitly remove an attribute.
+
+### Comparison between 2.x & 3.x behavior
+
+<table>
+  <thead>
+    <tr>
+      <th>Attribute</th>
+      <th><code>v-bind</code> value <sup>2.x</sup></th>
+      <th><code>v-bind</code> value <sup>3.x</sup></th>
+      <th>HTML output</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td rowspan="3">2.x “Enumerated attrs”<br><small>i.e. <code>contenteditable</code>, <code>draggable</code> and <code>spellcheck</code>.</small></td>
+      <td><code>undefined</code>, <code>false</code></td>
+      <td><code>undefined</code>, <code>null</code></td>
+      <td><i>removed</i></td>
+    </tr>
+    <tr>
+      <td>
+        <code>true</code>, <code>'true'</code>, <code>''</code>, <code>1</code>,
+        <code>'foo'</code>
+      </td>
+      <td><code>true</code>, <code>'true'</code></td>
+      <td><code>"true"</code></td>
+    </tr>
+    <tr>
+      <td><code>null</code>, <code>'false'</code></td>
+      <td><code>false</code>, <code>'false'</code></td>
+      <td><code>"false"</code></td>
+    </tr>
+    <tr>
+      <td rowspan="2">Other non-boolean attrs<br><small>eg. <code>aria-checked</code>, <code>tabindex</code>, <code>alt</code>, etc.</small></td>
+      <td><code>undefined</code>, <code>null</code>, <code>false</code></td>
+      <td><code>undefined</code>, <code>null</code></td>
+      <td><i>removed</i></td>
+    </tr>
+    <tr>
+      <td><code>'false'</code></td>
+      <td><code>false</code>, <code>'false'</code></td>
+      <td><code>"false"</code></td>
+    </tr>
+  </tbody>
+</table>

From 07e4341c0602ab242bf6eb375f99f258ad91b2a4 Mon Sep 17 00:00:00 2001
From: Ben Hong <ben@bencodezen.io>
Date: Tue, 14 Jul 2020 23:55:09 -0400
Subject: [PATCH 2/9] docs (#149): enforce consistent quotes

Co-authored-by: Natalia Tepluhina <tarya.se@gmail.com>
---
 src/guide/migration/attribute-coercion.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/guide/migration/attribute-coercion.md b/src/guide/migration/attribute-coercion.md
index 82b1f522ad..5adb826334 100644
--- a/src/guide/migration/attribute-coercion.md
+++ b/src/guide/migration/attribute-coercion.md
@@ -19,7 +19,7 @@ In 2.x, we had the following strategies for coercing `v-bind` values:
 
 - For some attribute/element pairs, Vue is always using the corresponding IDL attribute (property): [like `value` of `<input>`, `<select>`, `<progress>`, etc](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L11-L18).
 
-- For “[boolean attributes](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L33-L40)” and [xlinks](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L44-L46), Vue removes them if they are “falsy” ([`undefined`, `null` or `false`](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L52-L54)) and adds them otherwise (see [here](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/runtime/modules/attrs.js#L66-L77) and [here](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/runtime/modules/attrs.js#L81-L85)).
+- For "[boolean attributes](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L33-L40)" and [xlinks](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L44-L46), Vue removes them if they are "falsy" ([`undefined`, `null` or `false`](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L52-L54)) and adds them otherwise (see [here](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/runtime/modules/attrs.js#L66-L77) and [here](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/runtime/modules/attrs.js#L81-L85)).
 
 - For “[enumerated attributes](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L20)” (currently `contenteditable`, `draggable` and `spellcheck`), Vue tries to [coerce](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L24-L31) them to string (with special treatment for `contenteditable` for now, to fix [vuejs/vue#9397](https://github.com/vuejs/vue/issues/9397)).
 

From 285fac070a1963728fb631c5757f35a3a5383de0 Mon Sep 17 00:00:00 2001
From: Ben Hong <ben@bencodezen.io>
Date: Tue, 14 Jul 2020 23:55:24 -0400
Subject: [PATCH 3/9] docs (#149): enforce consistent quotes

Co-authored-by: Natalia Tepluhina <tarya.se@gmail.com>
---
 src/guide/migration/attribute-coercion.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/guide/migration/attribute-coercion.md b/src/guide/migration/attribute-coercion.md
index 5adb826334..fdd508374e 100644
--- a/src/guide/migration/attribute-coercion.md
+++ b/src/guide/migration/attribute-coercion.md
@@ -21,7 +21,7 @@ In 2.x, we had the following strategies for coercing `v-bind` values:
 
 - For "[boolean attributes](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L33-L40)" and [xlinks](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L44-L46), Vue removes them if they are "falsy" ([`undefined`, `null` or `false`](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L52-L54)) and adds them otherwise (see [here](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/runtime/modules/attrs.js#L66-L77) and [here](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/runtime/modules/attrs.js#L81-L85)).
 
-- For “[enumerated attributes](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L20)” (currently `contenteditable`, `draggable` and `spellcheck`), Vue tries to [coerce](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L24-L31) them to string (with special treatment for `contenteditable` for now, to fix [vuejs/vue#9397](https://github.com/vuejs/vue/issues/9397)).
+- For "[enumerated attributes](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L20)" (currently `contenteditable`, `draggable` and `spellcheck`), Vue tries to [coerce](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L24-L31) them to string (with special treatment for `contenteditable` for now, to fix [vuejs/vue#9397](https://github.com/vuejs/vue/issues/9397)).
 
 - For other attributes, we remove “falsy” values (`undefined`, `null`, or `false`) and set other values as-is (see [here](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/runtime/modules/attrs.js#L92-L113)).
 

From 43d29a6df63058e96ad2fd0f97cb2f04d10cc994 Mon Sep 17 00:00:00 2001
From: Ben Hong <ben@bencodezen.io>
Date: Tue, 14 Jul 2020 23:55:32 -0400
Subject: [PATCH 4/9] docs (#149): enforce consistent quotes

Co-authored-by: Natalia Tepluhina <tarya.se@gmail.com>
---
 src/guide/migration/attribute-coercion.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/guide/migration/attribute-coercion.md b/src/guide/migration/attribute-coercion.md
index fdd508374e..3003de5b09 100644
--- a/src/guide/migration/attribute-coercion.md
+++ b/src/guide/migration/attribute-coercion.md
@@ -25,7 +25,7 @@ In 2.x, we had the following strategies for coercing `v-bind` values:
 
 - For other attributes, we remove “falsy” values (`undefined`, `null`, or `false`) and set other values as-is (see [here](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/runtime/modules/attrs.js#L92-L113)).
 
-The following table describes how Vue coerce “enumerated attributes” differently with normal non-boolean attributes:
+The following table describes how Vue coerce "enumerated attributes" differently with normal non-boolean attributes:
 
 | Binding expr.       | `foo` <sup>normal</sup> | `draggable` <sup>enumerated</sup> |
 | ------------------- | ----------------------- | --------------------------------- |

From 4631408de37dd9caabe2049e28ee0e23aa1f756a Mon Sep 17 00:00:00 2001
From: Ben Hong <ben@bencodezen.io>
Date: Tue, 14 Jul 2020 23:55:50 -0400
Subject: [PATCH 5/9] docs (#149): spell out abbreviation

Co-authored-by: Natalia Tepluhina <tarya.se@gmail.com>
---
 src/guide/migration/attribute-coercion.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/guide/migration/attribute-coercion.md b/src/guide/migration/attribute-coercion.md
index 3003de5b09..f2ac4e1ff2 100644
--- a/src/guide/migration/attribute-coercion.md
+++ b/src/guide/migration/attribute-coercion.md
@@ -27,7 +27,7 @@ In 2.x, we had the following strategies for coercing `v-bind` values:
 
 The following table describes how Vue coerce "enumerated attributes" differently with normal non-boolean attributes:
 
-| Binding expr.       | `foo` <sup>normal</sup> | `draggable` <sup>enumerated</sup> |
+| Binding expression       | `foo` <sup>normal</sup> | `draggable` <sup>enumerated</sup> |
 | ------------------- | ----------------------- | --------------------------------- |
 | `:attr="null"`      | /                       | `draggable="false"`               |
 | `:attr="undefined"` | /                       | /                                 |

From 3a4bf47a5280aa77ca25d8ea896e21d14bb11201 Mon Sep 17 00:00:00 2001
From: Ben Hong <ben@bencodezen.io>
Date: Tue, 14 Jul 2020 23:56:03 -0400
Subject: [PATCH 6/9] docs (#149): enforce consistent quotes

Co-authored-by: Natalia Tepluhina <tarya.se@gmail.com>
---
 src/guide/migration/attribute-coercion.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/guide/migration/attribute-coercion.md b/src/guide/migration/attribute-coercion.md
index f2ac4e1ff2..4d10cd9d1b 100644
--- a/src/guide/migration/attribute-coercion.md
+++ b/src/guide/migration/attribute-coercion.md
@@ -42,7 +42,7 @@ We can see from the table above, current implementation coerces `true` to `'true
 
 ## 3.x Syntax
 
-We intend to drop this internal concept of “enumerated attributes” and treat them as normal non-boolean HTML attributes.
+We intend to drop this internal concept of "enumerated attributes" and treat them as normal non-boolean HTML attributes.
 
 - This solves the inconsistency between normal non-boolean attributes and “enumerated attributes”
 - It also makes it possible to use values other than `'true'` and `'false'`, or even keywords yet to come, for attributes like `contenteditable`

From 2bd6075863d28f4e927b0c5449e1fc11fa4642cc Mon Sep 17 00:00:00 2001
From: Ben Hong <ben@bencodezen.io>
Date: Tue, 14 Jul 2020 23:56:17 -0400
Subject: [PATCH 7/9] docs (#149): spell out abbreviation

Co-authored-by: Natalia Tepluhina <tarya.se@gmail.com>
---
 src/guide/migration/attribute-coercion.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/guide/migration/attribute-coercion.md b/src/guide/migration/attribute-coercion.md
index 4d10cd9d1b..26ba6a1df5 100644
--- a/src/guide/migration/attribute-coercion.md
+++ b/src/guide/migration/attribute-coercion.md
@@ -53,7 +53,7 @@ For non-boolean attributes, Vue will stop removing them if they are `false` and
 
 The following table describes the new behavior:
 
-| Binding expr.       | `foo` <sup>normal</sup>    | `draggable` <sup>enumerated</sup> |
+| Binding expression       | `foo` <sup>normal</sup>    | `draggable` <sup>enumerated</sup> |
 | ------------------- | -------------------------- | --------------------------------- |
 | `:attr="null"`      | /                          | / <sup>†</sup>                    |
 | `:attr="undefined"` | /                          | /                                 |

From a81932bf75397da47d322553cb93419961c9549c Mon Sep 17 00:00:00 2001
From: Ben Hong <ben@bencodezen.io>
Date: Tue, 14 Jul 2020 23:56:28 -0400
Subject: [PATCH 8/9] docs (#149): enforce consistent quotes

Co-authored-by: Natalia Tepluhina <tarya.se@gmail.com>
---
 src/guide/migration/attribute-coercion.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/guide/migration/attribute-coercion.md b/src/guide/migration/attribute-coercion.md
index 26ba6a1df5..ab38246bf0 100644
--- a/src/guide/migration/attribute-coercion.md
+++ b/src/guide/migration/attribute-coercion.md
@@ -23,7 +23,7 @@ In 2.x, we had the following strategies for coercing `v-bind` values:
 
 - For "[enumerated attributes](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L20)" (currently `contenteditable`, `draggable` and `spellcheck`), Vue tries to [coerce](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/util/attrs.js#L24-L31) them to string (with special treatment for `contenteditable` for now, to fix [vuejs/vue#9397](https://github.com/vuejs/vue/issues/9397)).
 
-- For other attributes, we remove “falsy” values (`undefined`, `null`, or `false`) and set other values as-is (see [here](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/runtime/modules/attrs.js#L92-L113)).
+- For other attributes, we remove "falsy" values (`undefined`, `null`, or `false`) and set other values as-is (see [here](https://github.com/vuejs/vue/blob/bad3c326a3f8b8e0d3bcf07917dc0adf97c32351/src/platforms/web/runtime/modules/attrs.js#L92-L113)).
 
 The following table describes how Vue coerce "enumerated attributes" differently with normal non-boolean attributes:
 

From 589119714f2e58c2b107d99c2fad71c09cd361db Mon Sep 17 00:00:00 2001
From: Ben Hong <ben@bencodezen.io>
Date: Wed, 15 Jul 2020 15:38:26 -0400
Subject: [PATCH 9/9] fix: alphabetical order

---
 src/.vuepress/config.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/.vuepress/config.js b/src/.vuepress/config.js
index 07572bbfb2..14090ad072 100644
--- a/src/.vuepress/config.js
+++ b/src/.vuepress/config.js
@@ -93,8 +93,8 @@ const sidebar = {
       collapsable: true,
       children: [
         'migration/introduction',
-        'migration/attribute-coercion',
         'migration/async-components',
+        'migration/attribute-coercion',
         'migration/custom-directives',
         'migration/custom-elements-interop',
         'migration/data-option',