diff --git a/README.md b/README.md
index 8382a6647..62121c2e1 100644
--- a/README.md
+++ b/README.md
@@ -97,6 +97,7 @@ The `--fix` option on the command line automatically fixes problems reported by
 |  | [no-reserved-keys](./docs/rules/no-reserved-keys.md) | disallow overwriting reserved keys |
 |  | [no-shared-component-data](./docs/rules/no-shared-component-data.md) | enforce component's data property to be a function |
 |  | [no-template-key](./docs/rules/no-template-key.md) | disallow `key` attribute on `<template>` |
+|  | [no-unused-vars](./docs/rules/no-unused-vars.md) | disallow unused variable definitions of v-for directives or scope attributes |
 |  | [require-render-return](./docs/rules/require-render-return.md) | enforce render function to always return value |
 |  | [require-valid-default-prop](./docs/rules/require-valid-default-prop.md) | enforce props default values to be valid |
 |  | [return-in-computed-property](./docs/rules/return-in-computed-property.md) | enforce that a return statement is present in computed property |
diff --git a/docs/rules/no-unused-vars.md b/docs/rules/no-unused-vars.md
index a48f63c33..bd71a3c0c 100644
--- a/docs/rules/no-unused-vars.md
+++ b/docs/rules/no-unused-vars.md
@@ -1,4 +1,4 @@
-# Disallow unused variable definitions of v-for directives or scope attributes. (no-unused-vars)
+# disallow unused variable definitions of v-for directives or scope attributes (no-unused-vars)
 
 This rule report variable definitions of v-for directives or scope attributes if those are not used.
 
diff --git a/lib/recommended-rules.js b/lib/recommended-rules.js
index d332ae561..18604033c 100644
--- a/lib/recommended-rules.js
+++ b/lib/recommended-rules.js
@@ -40,6 +40,7 @@ module.exports = {
   "vue/no-side-effects-in-computed-properties": "off",
   "vue/no-template-key": "off",
   "vue/no-textarea-mustache": "error",
+  "vue/no-unused-vars": "off",
   "vue/order-in-components": "off",
   "vue/require-component-is": "error",
   "vue/require-default-prop": "off",
diff --git a/lib/rules/no-unused-vars.js b/lib/rules/no-unused-vars.js
index c329aecf8..8aadc0a2e 100644
--- a/lib/rules/no-unused-vars.js
+++ b/lib/rules/no-unused-vars.js
@@ -1,5 +1,5 @@
 /**
- * @fileoverview warn variable definitions of v-for directives or scope attributes if those are not used.
+ * @fileoverview disallow unused variable definitions of v-for directives or scope attributes.
  * @author 薛定谔的猫<hh_2013@foxmail.com>
  */
 'use strict'
@@ -37,7 +37,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'warn variable definitions of v-for directives or scope attributes if those are not used',
+      description: 'disallow unused variable definitions of v-for directives or scope attributes',
       category: 'Possible Errors',
       recommended: false
     },