From 35c3be2ce4b1926581d77cc69236a795efe86118 Mon Sep 17 00:00:00 2001
From: ota <y.ohta.z3@future.co.jp>
Date: Thu, 17 Sep 2020 09:47:11 +0900
Subject: [PATCH 1/3] Update documentations

---
 README.md                               |  8 ---
 docs/.vuepress/theme/index.js           |  3 -
 docs/.vuepress/theme/layouts/Layout.vue | 77 -------------------------
 docs/README.md                          |  4 ++
 docs/user-guide/README.md               | 33 +++++++++--
 package.json                            |  3 -
 6 files changed, 33 insertions(+), 95 deletions(-)
 delete mode 100644 docs/.vuepress/theme/index.js
 delete mode 100644 docs/.vuepress/theme/layouts/Layout.vue

diff --git a/README.md b/README.md
index 52fb216ef..c34728c49 100644
--- a/README.md
+++ b/README.md
@@ -11,14 +11,6 @@
 
 See [the official website](https://eslint.vuejs.org).
 
-> :exclamation: Attention - this is documentation for version `7.x` :exclamation:
->
-> This branch contains `eslint-plugin-vue@next` which is a pre-released `7.0`, but it's not the default version that you get with `npm install eslint-plugin-vue`. In order to install this you need to specify either `"eslint-plugin-vue": "next"` in `package.json` or do `npm install eslint-plugin-vue@next`.
->
-> Please try it and report any issues that you might have encountered.
->
-> If you want to check previous releases [go here](https://github.com/vuejs/eslint-plugin-vue/releases).
-
 ## :anchor: Versioning Policy
 
 This plugin is following [Semantic Versioning](https://semver.org/) and [ESLint's Semantic Versioning Policy](https://github.com/eslint/eslint#semantic-versioning-policy).
diff --git a/docs/.vuepress/theme/index.js b/docs/.vuepress/theme/index.js
deleted file mode 100644
index b91b8a576..000000000
--- a/docs/.vuepress/theme/index.js
+++ /dev/null
@@ -1,3 +0,0 @@
-module.exports = {
-  extend: '@vuepress/theme-default'
-}
diff --git a/docs/.vuepress/theme/layouts/Layout.vue b/docs/.vuepress/theme/layouts/Layout.vue
deleted file mode 100644
index 43b5ad685..000000000
--- a/docs/.vuepress/theme/layouts/Layout.vue
+++ /dev/null
@@ -1,77 +0,0 @@
-<template>
-  <BaseLayout v-bind="$attrs" v-on="$listeners">
-    <slot name="sidebar-top" slot="sidebar-top" />
-    <slot name="sidebar-bottom" slot="sidebar-bottom" />
-    <template slot="page-top">
-      <div class="theme-default-content beta-doc-description">
-        <div class="warning custom-block">
-          <p class="custom-block-title">Note</p>
-          <p>
-            This is a documentation for version <code>{{ docVersion }}</code
-            >.<template v-if="hasNotYetBeenReleased">
-              Also, this documentation may contain content that has not yet been
-              released.</template
-            ><br />
-            To check version <code>6.2.2</code>
-            <a :href="v6DocLink">go here</a>. To check previous releases
-            <a href="https://github.com/vuejs/eslint-plugin-vue/releases"
-              >go here</a
-            >.
-          </p>
-        </div>
-      </div>
-      <slot name="page-top" />
-    </template>
-    <slot name="page-bottom" slot="page-bottom" />
-  </BaseLayout>
-</template>
-
-<script>
-/**
- * Layout definition to navigate to older versions of the document.
- */
-import BaseLayout from '@vuepress/theme-default/layouts/Layout.vue'
-import semver from 'semver'
-const version = semver.parse(require('../../../../package.json').version)
-export default {
-  name: 'MyLayout',
-  components: {
-    BaseLayout
-  },
-  computed: {
-    docVersion() {
-      if (version.major < 7) {
-        return '7.x'
-      }
-      return version.raw
-    },
-    hasNotYetBeenReleased() {
-      if (version.major < 7) {
-        return true
-      }
-      return false
-    },
-    v6DocLink() {
-      if (this.$page.path.endsWith('.html')) {
-        return `https://github.com/vuejs/eslint-plugin-vue/blob/v6.2.2/docs${this.$page.path.replace(
-          /\.html$/,
-          ''
-        )}.md`
-      }
-      return `https://github.com/vuejs/eslint-plugin-vue/blob/v6.2.2/docs${this.$page.path}README.md`
-    }
-  }
-}
-</script>
-
-<style scoped>
-.beta-doc-description {
-  padding-bottom: 0;
-}
-* ::v-deep .theme-default-content ~ .theme-default-content {
-  padding-top: 0;
-}
-* ::v-deep .theme-default-content:not(.custom) h1 {
-  margin-top: -3.1rem;
-}
-</style>
diff --git a/docs/README.md b/docs/README.md
index 8bb745619..fe739cc26 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -14,6 +14,10 @@ This plugin allows us to check the `<template>` and `<script>` of `.vue` files w
 
 ESLint editor integrations are useful to check your code in real-time.
 
+:::warning Status of Vue.js 3.x supports
+This plugin supports the basic syntax of Vue.js 3.0, but the Vue.js 3.0 experimental features `<script setup>` and `<style vars>` are not yet supported. Follow [#1248](https://github.com/vuejs/eslint-plugin-vue/issues/1248) for more details.
+:::
+
 ## :traffic_light: Versioning policy
 
 This plugin is following [Semantic Versioning](https://semver.org/) and [ESLint's Semantic Versioning Policy](https://github.com/eslint/eslint#semantic-versioning-policy).
diff --git a/docs/user-guide/README.md b/docs/user-guide/README.md
index 82e8393a8..3c5bd2696 100644
--- a/docs/user-guide/README.md
+++ b/docs/user-guide/README.md
@@ -3,23 +3,28 @@
 ## :cd: Installation
 
 Via `vue-cli` (**Recommended**):
+
 ```bash
 vue add @vue/cli-plugin-eslint
 ```
 
 Via [npm](https://www.npmjs.com/):
+
 ```bash
-npm install --save-dev eslint eslint-plugin-vue@next
+npm install --save-dev eslint eslint-plugin-vue
 ```
 
 Via [yarn](https://yarnpkg.com/):
+
 ```bash
-yarn add -D eslint eslint-plugin-vue@next
+yarn add -D eslint eslint-plugin-vue
 ```
 
 ::: tip Requirements
+
 - ESLint v6.2.0 and above
 - Node.js v8.10.0 and above
+
 :::
 
 ## :book: Usage
@@ -35,7 +40,8 @@ module.exports = {
   extends: [
     // add more generic rulesets here, such as:
     // 'eslint:recommended',
-    'plugin:vue/vue3-recommended'
+    'plugin:vue/vue3-recommended',
+    // 'plugin:vue/recommended' // Use this if you are using Vue.js 2.x.
   ],
   rules: {
     // override/add rules settings here, such as:
@@ -46,8 +52,27 @@ module.exports = {
 
 See [the rule list](../rules/README.md) to get the `extends` &amp; `rules` that this plugin provides.
 
+#### Bundle Configurations
+
+This plugin provides some predefined configs.
+You can use the following configs by adding them to `extends`.
+
+- `"plugin:vue/base"` ... Settings and rules to enable correct ESLint parsing.
+- Configurations for using Vue.js 3.x.
+  - `"plugin:vue/vue3-essential"` ... `base`, plus rules to prevent errors or unintended behavior.
+  - `"plugin:vue/vue3-strongly-recommended"` ... Above, plus rules to considerably improve code readability and/or dev experience.
+  - `"plugin:vue/vue3-recommended"` ... Above, plus rules to enforce subjective community defaults to ensure consistency.
+- Configurations for using Vue.js 2.x.
+  - `"plugin:vue/essential"` ... `base`, plus rules to prevent errors or unintended behavior.
+  - `"plugin:vue/strongly-recommended"` ... Above, plus rules to considerably improve code readability and/or dev experience.
+  - `"plugin:vue/recommended"` ... Above, plus rules to enforce subjective community defaults to ensure consistency
+
 :::warning Reporting rules
-By default all rules from **base** and **essential** categories report ESLint errors. Other rules - because they're not covering potential bugs in the application - report warnings. What does it mean? By default - nothing, but if you want - you can set up a treshold and break the build after a certain amount of warnings, instead of any. More information [here](https://eslint.org/docs/user-guide/command-line-interface#handling-warnings).
+By default all rules from **base** and **essential** categories report ESLint errors. Other rules - because they're not covering potential bugs in the application - report warnings. What does it mean? By default - nothing, but if you want - you can set up a threshold and break the build after a certain amount of warnings, instead of any. More information [here](https://eslint.org/docs/user-guide/command-line-interface#handling-warnings).
+:::
+
+:::warning Status of Vue.js 3.x supports
+This plugin supports the basic syntax of Vue.js 3.0, but the Vue.js 3.0 experimental features `<script setup>` and `<style vars>` are not yet supported. Follow [#1248](https://github.com/vuejs/eslint-plugin-vue/issues/1248) for more details.
 :::
 
 ### Running ESLint from the command line
diff --git a/package.json b/package.json
index 018321703..aee6effe1 100644
--- a/package.json
+++ b/package.json
@@ -80,8 +80,5 @@
     "typescript": "^3.9.5",
     "vue-eslint-editor": "^1.1.0",
     "vuepress": "^1.4.1"
-  },
-  "publishConfig": {
-    "tag": "next"
   }
 }

From 489febc73272307ee15bc4086488fbfe43fbde88 Mon Sep 17 00:00:00 2001
From: ota <y.ohta.z3@future.co.jp>
Date: Sat, 19 Sep 2020 09:50:48 +0900
Subject: [PATCH 2/3] updatte

---
 docs/rules/attributes-order.md          | 2 +-
 docs/rules/match-component-file-name.md | 2 +-
 docs/rules/no-shared-component-data.md  | 1 -
 docs/user-guide/README.md               | 6 +++---
 4 files changed, 5 insertions(+), 6 deletions(-)

diff --git a/docs/rules/attributes-order.md b/docs/rules/attributes-order.md
index c6391ffa6..ea8c4ae9c 100644
--- a/docs/rules/attributes-order.md
+++ b/docs/rules/attributes-order.md
@@ -12,7 +12,7 @@ description: enforce order of attributes
 
 ## :book: Rule Details
 
-This rule aims to enforce ordering of component attributes. The default order is specified in the [Vue styleguide](https://v3.vuejs.org/style-guide/#element-attribute-order-recommended) and is:
+This rule aims to enforce ordering of component attributes. The default order is specified in the [Vue.js Style Guide](https://v3.vuejs.org/style-guide/#element-attribute-order-recommended) and is:
 
 - `DEFINITION`
   e.g. 'is', 'v-is'
diff --git a/docs/rules/match-component-file-name.md b/docs/rules/match-component-file-name.md
index 1ae1989fc..7e454a8af 100644
--- a/docs/rules/match-component-file-name.md
+++ b/docs/rules/match-component-file-name.md
@@ -306,7 +306,7 @@ export default {
 
 ## :books: Further Reading
 
- - [Style guide - Single-file component filename casing](https://v3.vuejs.org/style-guide/#single-file-component-filename-casing-strongly-recommended)
+- [Style guide - Single-file component filename casing](https://v3.vuejs.org/style-guide/#single-file-component-filename-casing-strongly-recommended)
 
 ## :mag: Implementation
 
diff --git a/docs/rules/no-shared-component-data.md b/docs/rules/no-shared-component-data.md
index a869b8000..2b0fb706a 100644
--- a/docs/rules/no-shared-component-data.md
+++ b/docs/rules/no-shared-component-data.md
@@ -68,7 +68,6 @@ Nothing.
 
 ## :books: Further Reading
 
-
 - [Style guide (for v2) - Component data](https://vuejs.org/v2/style-guide/#Component-data-essential)
 - [API - data](https://v3.vuejs.org/api/options-data.html#data-2)
 - [API (for v2) - data](https://v3.vuejs.org/api/options-data.html#data-2)
diff --git a/docs/user-guide/README.md b/docs/user-guide/README.md
index 3c5bd2696..552a1bdf1 100644
--- a/docs/user-guide/README.md
+++ b/docs/user-guide/README.md
@@ -77,7 +77,7 @@ This plugin supports the basic syntax of Vue.js 3.0, but the Vue.js 3.0 experime
 
 ### Running ESLint from the command line
 
-If you want to run `eslint` from the command line, make sure you include the `.vue` extension using [the `--ext` option](https://eslint.org/docs/user-guide/configuring#specifying-file-extensions-to-lint) or a glob pattern, because ESLint targets only `.js` files by default.
+If you want to run `eslint` from the command line, make sure you include the `.vue` extension using [the `--ext` option](https://eslint.org/docs/user-guide/configuring#specifying-target-files-to-lint) or a glob pattern, because ESLint targets only `.js` files by default.
 
 Examples:
 
@@ -245,7 +245,7 @@ See also: "[How to use a custom parser?](#how-to-use-a-custom-parser)" section.
   - CLI targets only `.js` files by default. You have to specify additional extensions with the `--ext` option or glob patterns. E.g. `eslint "src/**/*.{js,vue}"` or `eslint src --ext .vue`. If you use `@vue/cli-plugin-eslint` and the `vue-cli-service lint` command - you don't have to worry about it.
   - If you are having issues with configuring editor, please read [editor integrations](#editor-integrations)
 
-### Conflict with [Prettier].
+### Conflict with [Prettier]
 
 If the [Prettier] conflicts with the shareable config provided by this plugin, use [eslint-config-prettier] to resolve it.
 
@@ -291,7 +291,7 @@ module.exports = {
 [prettier]: https://prettier.io/
 [eslint-config-prettier]: https://github.com/prettier/eslint-config-prettier
 
-### Using JSX.
+### Using JSX
 
 If you are using JSX, you need to enable JSX in your ESLint configuration.
 

From c46463202d98e71e7bf13b02eff7fb2369942322 Mon Sep 17 00:00:00 2001
From: ota <y.ohta.z3@future.co.jp>
Date: Sat, 19 Sep 2020 10:56:52 +0900
Subject: [PATCH 3/3] update docs

---
 docs/rules/no-deprecated-data-object-declaration.md | 3 +++
 docs/rules/no-deprecated-dollar-scopedslots-api.md  | 3 +++
 docs/rules/no-deprecated-events-api.md              | 3 +++
 docs/rules/no-deprecated-filter.md                  | 5 ++++-
 docs/rules/no-deprecated-functional-template.md     | 5 ++++-
 docs/rules/no-deprecated-html-element-is.md         | 5 ++++-
 docs/rules/no-deprecated-inline-template.md         | 5 ++++-
 docs/rules/no-deprecated-v-bind-sync.md             | 5 ++++-
 docs/rules/no-deprecated-v-on-number-modifiers.md   | 5 ++++-
 docs/rules/no-deprecated-vue-config-keycodes.md     | 6 +++++-
 docs/rules/no-v-for-template-key-on-child.md        | 6 ++++++
 11 files changed, 44 insertions(+), 7 deletions(-)

diff --git a/docs/rules/no-deprecated-data-object-declaration.md b/docs/rules/no-deprecated-data-object-declaration.md
index dfc84989c..4724226db 100644
--- a/docs/rules/no-deprecated-data-object-declaration.md
+++ b/docs/rules/no-deprecated-data-object-declaration.md
@@ -15,6 +15,8 @@ description: disallow using deprecated object declaration on data (in Vue.js 3.0
 This rule reports use of deprecated object declaration on `data` property (in Vue.js 3.0.0+).
 The different from `vue/no-shared-component-data` is the root instance being also disallowed.
 
+See [Migration Guide - Data Option](https://v3.vuejs.org/guide/migration/data-option.html) for more details.
+
 <eslint-code-block fix :rules="{'vue/no-deprecated-data-object-declaration': ['error']}" language="javascript" filename="example.js">
 
 ```js
@@ -75,6 +77,7 @@ Nothing.
 
 ## :books: Further Reading
 
+- [Migration Guide - Data Option](https://v3.vuejs.org/guide/migration/data-option.html)
 - [Vue RFCs - 0019-remove-data-object-declaration](https://github.com/vuejs/rfcs/blob/master/active-rfcs/0019-remove-data-object-declaration.md)
 
 ## :mag: Implementation
diff --git a/docs/rules/no-deprecated-dollar-scopedslots-api.md b/docs/rules/no-deprecated-dollar-scopedslots-api.md
index 63b4e70e6..c497acb8f 100644
--- a/docs/rules/no-deprecated-dollar-scopedslots-api.md
+++ b/docs/rules/no-deprecated-dollar-scopedslots-api.md
@@ -14,6 +14,8 @@ description: disallow using deprecated `$scopedSlots` (in Vue.js 3.0.0+)
 
 This rule reports use of deprecated `$scopedSlots`. (in Vue.js 3.0.0+).
 
+See [Migration Guide - Slots Unification](https://v3.vuejs.org/guide/migration/slots-unification.html) for more details.
+
 <eslint-code-block fix :rules="{'vue/no-deprecated-dollar-scopedslots-api': ['error']}">
 
 ```vue
@@ -39,6 +41,7 @@ Nothing.
 
 ## :books: Further Reading
 
+- [Migration Guide - Slots Unification](https://v3.vuejs.org/guide/migration/slots-unification.html)
 - [Vue RFCs - 0006-slots-unification](https://github.com/vuejs/rfcs/blob/master/active-rfcs/0006-slots-unification.md)
 
 ## :mag: Implementation
diff --git a/docs/rules/no-deprecated-events-api.md b/docs/rules/no-deprecated-events-api.md
index a73d88401..1d268b74b 100644
--- a/docs/rules/no-deprecated-events-api.md
+++ b/docs/rules/no-deprecated-events-api.md
@@ -13,6 +13,8 @@ description: disallow using deprecated events api (in Vue.js 3.0.0+)
 
 This rule reports use of deprecated `$on`, `$off` `$once` api. (in Vue.js 3.0.0+).
 
+See [Migration Guide - Events API](https://v3.vuejs.org/guide/migration/events-api.html) for more details.
+
 <eslint-code-block :rules="{'vue/no-deprecated-events-api': ['error']}">
 
 ```vue
@@ -57,6 +59,7 @@ Nothing.
 
 ## :books: Further Reading
 
+- [Migration Guide - Events API](https://v3.vuejs.org/guide/migration/events-api.html)
 - [Vue RFCs - 0020-events-api-change](https://github.com/vuejs/rfcs/blob/master/active-rfcs/0020-events-api-change.md)
 
 ## :mag: Implementation
diff --git a/docs/rules/no-deprecated-filter.md b/docs/rules/no-deprecated-filter.md
index cba1380f3..13a1aa9d4 100644
--- a/docs/rules/no-deprecated-filter.md
+++ b/docs/rules/no-deprecated-filter.md
@@ -11,7 +11,9 @@ description: disallow using deprecated filters syntax (in Vue.js 3.0.0+)
 
 ## :book: Rule Details
 
-This rule reports deprecated `filters` syntax (removed in Vue.js v3.0.0+)
+This rule reports deprecated `filters` syntax (removed in Vue.js v3.0.0+).
+
+See [Migration Guide - Filters](https://v3.vuejs.org/guide/migration/filters.html) for more details.
 
 <eslint-code-block :rules="{'vue/no-deprecated-filter': ['error']}">
 
@@ -43,6 +45,7 @@ Nothing.
 
 ## :books: Further Reading
 
+- [Migration Guide - Filters](https://v3.vuejs.org/guide/migration/filters.html)
 - [Vue RFCs - 0015-remove-filters](https://github.com/vuejs/rfcs/blob/master/active-rfcs/0015-remove-filters.md)
 
 ## :mag: Implementation
diff --git a/docs/rules/no-deprecated-functional-template.md b/docs/rules/no-deprecated-functional-template.md
index a7e288f73..bfd259b7b 100644
--- a/docs/rules/no-deprecated-functional-template.md
+++ b/docs/rules/no-deprecated-functional-template.md
@@ -11,7 +11,9 @@ description: disallow using deprecated the `functional` template (in Vue.js 3.0.
 
 ## :book: Rule Details
 
-This rule reports deprecated the `functional` template (in Vue.js 3.0.0+)
+This rule reports deprecated the `functional` template (in Vue.js 3.0.0+).
+
+See [Migration Guide - Functional Components](https://v3.vuejs.org/guide/migration/functional-components.html) for more details.
 
 <eslint-code-block :rules="{'vue/no-deprecated-functional-template': ['error']}">
 
@@ -30,6 +32,7 @@ Nothing.
 
 ## :books: Further Reading
 
+- [Migration Guide - Functional Components](https://v3.vuejs.org/guide/migration/functional-components.html)
 - [Vue RFCs - 0007-functional-async-api-change](https://github.com/vuejs/rfcs/blob/master/active-rfcs/0007-functional-async-api-change.md)
 - [Guide - Functional Components](https://vuejs.org/v2/guide/render-function.html#Functional-Components)
 
diff --git a/docs/rules/no-deprecated-html-element-is.md b/docs/rules/no-deprecated-html-element-is.md
index 800072b9c..406715fb1 100644
--- a/docs/rules/no-deprecated-html-element-is.md
+++ b/docs/rules/no-deprecated-html-element-is.md
@@ -11,7 +11,9 @@ description: disallow using deprecated the `is` attribute on HTML elements (in V
 
 ## :book: Rule Details
 
-This rule reports deprecated the `is` attribute on HTML elements (removed in Vue.js v3.0.0+)
+This rule reports deprecated the `is` attribute on HTML elements (removed in Vue.js v3.0.0+).
+
+See [Migration Guide - Custom Elements Interop](https://v3.vuejs.org/guide/migration/custom-elements-interop.html#customized-built-in-elements) for more details.
 
 <eslint-code-block :rules="{'vue/no-deprecated-html-element-is': ['error']}">
 
@@ -35,6 +37,7 @@ Nothing.
 
 ## :books: Further Reading
 
+- [Migration Guide - Custom Elements Interop](https://v3.vuejs.org/guide/migration/custom-elements-interop.html#customized-built-in-elements)
 - [Vue RFCs - 0027-custom-elements-interop](https://github.com/vuejs/rfcs/blob/master/active-rfcs/0027-custom-elements-interop.md)
 
 ## :mag: Implementation
diff --git a/docs/rules/no-deprecated-inline-template.md b/docs/rules/no-deprecated-inline-template.md
index 74f8c485c..eca07d446 100644
--- a/docs/rules/no-deprecated-inline-template.md
+++ b/docs/rules/no-deprecated-inline-template.md
@@ -11,7 +11,9 @@ description: disallow using deprecated `inline-template` attribute (in Vue.js 3.
 
 ## :book: Rule Details
 
-This rule reports deprecated `inline-template` attributes (removed in Vue.js v3.0.0+)
+This rule reports deprecated `inline-template` attributes (removed in Vue.js v3.0.0+).
+
+See [Migration Guide - Inline Template Attribute](https://v3.vuejs.org/guide/migration/inline-template-attribute.html) for more details.
 
 <eslint-code-block :rules="{'vue/no-deprecated-inline-template': ['error']}">
 
@@ -38,6 +40,7 @@ Nothing.
 
 ## :books: Further Reading
 
+- [Migration Guide - Inline Template Attribute](https://v3.vuejs.org/guide/migration/inline-template-attribute.html)
 - [Vue RFCs - 0016-remove-inline-templates](https://github.com/vuejs/rfcs/blob/master/active-rfcs/0016-remove-inline-templates.md)
 
 ## :mag: Implementation
diff --git a/docs/rules/no-deprecated-v-bind-sync.md b/docs/rules/no-deprecated-v-bind-sync.md
index e27f28047..41fa3d99a 100644
--- a/docs/rules/no-deprecated-v-bind-sync.md
+++ b/docs/rules/no-deprecated-v-bind-sync.md
@@ -12,7 +12,9 @@ description: disallow use of deprecated `.sync` modifier on `v-bind` directive (
 
 ## :book: Rule Details
 
-This rule reports use of deprecated `.sync` modifier on `v-bind` directive (in Vue.js 3.0.0+)
+This rule reports use of deprecated `.sync` modifier on `v-bind` directive (in Vue.js 3.0.0+).
+
+See [Migration Guide - `v-model`](https://v3.vuejs.org/guide/migration/v-model.html) for more details.
 
 <eslint-code-block fix :rules="{'vue/no-deprecated-v-bind-sync': ['error']}">
 
@@ -45,6 +47,7 @@ Nothing.
 
 ## :books: Further Reading
 
+- [Migration Guide - `v-model`](https://v3.vuejs.org/guide/migration/v-model.html)
 - [Vue RFCs - 0005-replace-v-bind-sync-with-v-model-argument](https://github.com/vuejs/rfcs/blob/master/active-rfcs/0005-replace-v-bind-sync-with-v-model-argument.md)
 
 ## :mag: Implementation
diff --git a/docs/rules/no-deprecated-v-on-number-modifiers.md b/docs/rules/no-deprecated-v-on-number-modifiers.md
index c0937aefa..2d7ece065 100644
--- a/docs/rules/no-deprecated-v-on-number-modifiers.md
+++ b/docs/rules/no-deprecated-v-on-number-modifiers.md
@@ -12,7 +12,9 @@ description: disallow using deprecated number (keycode) modifiers (in Vue.js 3.0
 
 ## :book: Rule Details
 
-This rule reports use of deprecated `KeyboardEvent.keyCode` modifier on `v-on` directive (in Vue.js 3.0.0+)
+This rule reports use of deprecated `KeyboardEvent.keyCode` modifier on `v-on` directive (in Vue.js 3.0.0+).
+
+See [Migration Guide - KeyCode Modifiers](https://v3.vuejs.org/guide/migration/keycode-modifiers.html) for more details.
 
 <eslint-code-block fix :rules="{'vue/no-deprecated-v-on-number-modifiers': ['error']}">
 
@@ -44,6 +46,7 @@ Nothing.
 
 ## :books: Further Reading
 
+- [Migration Guide - KeyCode Modifiers](https://v3.vuejs.org/guide/migration/keycode-modifiers.html)
 - [Vue RFCs - 0014-drop-keycode-support](https://github.com/vuejs/rfcs/blob/master/active-rfcs/0014-drop-keycode-support.md)
 
 ## :mag: Implementation
diff --git a/docs/rules/no-deprecated-vue-config-keycodes.md b/docs/rules/no-deprecated-vue-config-keycodes.md
index 18df590d1..1b394feb7 100644
--- a/docs/rules/no-deprecated-vue-config-keycodes.md
+++ b/docs/rules/no-deprecated-vue-config-keycodes.md
@@ -11,7 +11,9 @@ description: disallow using deprecated `Vue.config.keyCodes` (in Vue.js 3.0.0+)
 
 ## :book: Rule Details
 
-This rule reports use of deprecated `Vue.config.keyCodes` (in Vue.js 3.0.0+)
+This rule reports use of deprecated `Vue.config.keyCodes` (in Vue.js 3.0.0+).
+
+See [Migration Guide - KeyCode Modifiers](https://v3.vuejs.org/guide/migration/keycode-modifiers.html) for more details.
 
 <eslint-code-block filename="a.js" language="javascript" :rules="{'vue/no-deprecated-vue-config-keycodes': ['error']}">
 
@@ -36,9 +38,11 @@ Nothing.
 
 ## :books: Further Reading
 
+- [Migration Guide - KeyCode Modifiers]
 - [Vue RFCs - 0014-drop-keycode-support]
 - [API - Global Config - keyCodes]
 
+[Migration Guide - KeyCode Modifiers]: https://v3.vuejs.org/guide/migration/keycode-modifiers.html
 [Vue RFCs - 0014-drop-keycode-support]: https://github.com/vuejs/rfcs/blob/master/active-rfcs/0014-drop-keycode-support.md
 [API - Global Config - keyCodes]: https://vuejs.org/v2/api/#keyCodes
 
diff --git a/docs/rules/no-v-for-template-key-on-child.md b/docs/rules/no-v-for-template-key-on-child.md
index 982ddd5ef..bd56e4813 100644
--- a/docs/rules/no-v-for-template-key-on-child.md
+++ b/docs/rules/no-v-for-template-key-on-child.md
@@ -15,6 +15,8 @@ This rule reports the key of the `<template v-for>` placed on the child elements
 
 In Vue.js 3.x, with the support for fragments, the `<template v-for>` key can be placed on the `<template>` tag.  
 
+See [Migration Guide - `key` attribute > With `<template v-for>`](https://v3.vuejs.org/guide/migration/key-attribute.html#with-template-v-for) for more details.
+
 ::: warning Note
 Do not use with the [vue/no-v-for-template-key] rule for Vue.js 2.x.  
 This rule conflicts with the [vue/no-v-for-template-key] rule.
@@ -48,6 +50,10 @@ Nothing.
 
 [vue/no-v-for-template-key]: ./no-v-for-template-key.md
 
+## :books: Further Reading
+
+- [Migration Guide - `key` attribute > With `<template v-for>`](https://v3.vuejs.org/guide/migration/key-attribute.html#with-template-v-for)
+
 ## :mag: Implementation
 
 - [Rule source](https://github.com/vuejs/eslint-plugin-vue/blob/master/lib/rules/no-v-for-template-key-on-child.js)