diff --git a/.vscode/settings.json b/.vscode/settings.json
index ce072c82c..6287f25a9 100644
--- a/.vscode/settings.json
+++ b/.vscode/settings.json
@@ -1,3 +1,6 @@
 {
-    "editor.tabSize": 2
+    "editor.tabSize": 2,
+    "eslint.options": {
+        "rulePaths": ["eslint-internal-rules"]
+    }
 }
diff --git a/README.md b/README.md
index cf5bd5aa3..303f0b341 100644
--- a/README.md
+++ b/README.md
@@ -92,68 +92,68 @@ The `--fix` option on the command line automatically fixes problems reported by
 
 |    | Rule ID | Description |
 |:---|:--------|:------------|
-|  | [no-dupe-keys](./docs/rules/no-dupe-keys.md) | Prevents duplication of field names. |
-| :white_check_mark: | [no-parsing-error](./docs/rules/no-parsing-error.md) | disallow parsing errors in `<template>`. |
-|  | [no-reserved-keys](./docs/rules/no-reserved-keys.md) | Prevent overwrite reserved keys. |
-|  | [no-shared-component-data](./docs/rules/no-shared-component-data.md) | Enforces component's data property to be a function. |
-|  | [no-template-key](./docs/rules/no-template-key.md) | disallow `key` attribute on `<template>`. |
-|  | [require-render-return](./docs/rules/require-render-return.md) | Enforces render function to always return value. |
-|  | [require-valid-default-prop](./docs/rules/require-valid-default-prop.md) | Enforces props default values to be valid. |
-|  | [return-in-computed-property](./docs/rules/return-in-computed-property.md) | Enforces that a return statement is present in computed property. |
-| :white_check_mark: | [valid-template-root](./docs/rules/valid-template-root.md) | enforce valid template root. |
-| :white_check_mark: | [valid-v-bind](./docs/rules/valid-v-bind.md) | enforce valid `v-bind` directives. |
-| :white_check_mark: | [valid-v-cloak](./docs/rules/valid-v-cloak.md) | enforce valid `v-cloak` directives. |
-| :white_check_mark: | [valid-v-else-if](./docs/rules/valid-v-else-if.md) | enforce valid `v-else-if` directives. |
-| :white_check_mark: | [valid-v-else](./docs/rules/valid-v-else.md) | enforce valid `v-else` directives. |
-| :white_check_mark: | [valid-v-for](./docs/rules/valid-v-for.md) | enforce valid `v-for` directives. |
-| :white_check_mark: | [valid-v-html](./docs/rules/valid-v-html.md) | enforce valid `v-html` directives. |
-| :white_check_mark: | [valid-v-if](./docs/rules/valid-v-if.md) | enforce valid `v-if` directives. |
-| :white_check_mark: | [valid-v-model](./docs/rules/valid-v-model.md) | enforce valid `v-model` directives. |
-| :white_check_mark: | [valid-v-on](./docs/rules/valid-v-on.md) | enforce valid `v-on` directives. |
-| :white_check_mark: | [valid-v-once](./docs/rules/valid-v-once.md) | enforce valid `v-once` directives. |
-| :white_check_mark: | [valid-v-pre](./docs/rules/valid-v-pre.md) | enforce valid `v-pre` directives. |
-| :white_check_mark: | [valid-v-show](./docs/rules/valid-v-show.md) | enforce valid `v-show` directives. |
-| :white_check_mark: | [valid-v-text](./docs/rules/valid-v-text.md) | enforce valid `v-text` directives. |
+|  | [no-dupe-keys](./docs/rules/no-dupe-keys.md) | disallow duplication of field names |
+| :white_check_mark: | [no-parsing-error](./docs/rules/no-parsing-error.md) | disallow parsing errors in `<template>` |
+|  | [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>` |
+|  | [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 |
+| :white_check_mark: | [valid-template-root](./docs/rules/valid-template-root.md) | enforce valid template root |
+| :white_check_mark: | [valid-v-bind](./docs/rules/valid-v-bind.md) | enforce valid `v-bind` directives |
+| :white_check_mark: | [valid-v-cloak](./docs/rules/valid-v-cloak.md) | enforce valid `v-cloak` directives |
+| :white_check_mark: | [valid-v-else-if](./docs/rules/valid-v-else-if.md) | enforce valid `v-else-if` directives |
+| :white_check_mark: | [valid-v-else](./docs/rules/valid-v-else.md) | enforce valid `v-else` directives |
+| :white_check_mark: | [valid-v-for](./docs/rules/valid-v-for.md) | enforce valid `v-for` directives |
+| :white_check_mark: | [valid-v-html](./docs/rules/valid-v-html.md) | enforce valid `v-html` directives |
+| :white_check_mark: | [valid-v-if](./docs/rules/valid-v-if.md) | enforce valid `v-if` directives |
+| :white_check_mark: | [valid-v-model](./docs/rules/valid-v-model.md) | enforce valid `v-model` directives |
+| :white_check_mark: | [valid-v-on](./docs/rules/valid-v-on.md) | enforce valid `v-on` directives |
+| :white_check_mark: | [valid-v-once](./docs/rules/valid-v-once.md) | enforce valid `v-once` directives |
+| :white_check_mark: | [valid-v-pre](./docs/rules/valid-v-pre.md) | enforce valid `v-pre` directives |
+| :white_check_mark: | [valid-v-show](./docs/rules/valid-v-show.md) | enforce valid `v-show` directives |
+| :white_check_mark: | [valid-v-text](./docs/rules/valid-v-text.md) | enforce valid `v-text` directives |
 
 
 ### Best Practices
 
 |    | Rule ID | Description |
 |:---|:--------|:------------|
-| :wrench: | [html-end-tags](./docs/rules/html-end-tags.md) | enforce end tag style. |
-|  | [no-async-in-computed-properties](./docs/rules/no-async-in-computed-properties.md) | Check if there are no asynchronous actions inside computed properties. |
-| :white_check_mark: | [no-confusing-v-for-v-if](./docs/rules/no-confusing-v-for-v-if.md) | disallow confusing `v-for` and `v-if` on the same element. |
-|  | [no-duplicate-attributes](./docs/rules/no-duplicate-attributes.md) | disallow duplicate attributes. |
-|  | [no-side-effects-in-computed-properties](./docs/rules/no-side-effects-in-computed-properties.md) | Don't introduce side effects in computed properties |
-| :white_check_mark: | [no-textarea-mustache](./docs/rules/no-textarea-mustache.md) | disallow mustaches in `<textarea>`. |
-|  | [order-in-components](./docs/rules/order-in-components.md) | Keep order of properties in components |
-| :white_check_mark: | [require-component-is](./docs/rules/require-component-is.md) | require `v-bind:is` of `<component>` elements. |
-|  | [require-default-prop](./docs/rules/require-default-prop.md) | Require default value for props |
-|  | [require-prop-types](./docs/rules/require-prop-types.md) | Prop definitions should be detailed |
-| :white_check_mark: | [require-v-for-key](./docs/rules/require-v-for-key.md) | require `v-bind:key` with `v-for` directives. |
-|  | [this-in-template](./docs/rules/this-in-template.md) | enforce usage of `this` in template. |
+| :wrench: | [html-end-tags](./docs/rules/html-end-tags.md) | enforce end tag style |
+|  | [no-async-in-computed-properties](./docs/rules/no-async-in-computed-properties.md) | disallow asynchronous actions in computed properties |
+| :white_check_mark: | [no-confusing-v-for-v-if](./docs/rules/no-confusing-v-for-v-if.md) | disallow confusing `v-for` and `v-if` on the same element |
+|  | [no-duplicate-attributes](./docs/rules/no-duplicate-attributes.md) | disallow duplication of attributes |
+|  | [no-side-effects-in-computed-properties](./docs/rules/no-side-effects-in-computed-properties.md) | disallow side effects in computed properties |
+| :white_check_mark: | [no-textarea-mustache](./docs/rules/no-textarea-mustache.md) | disallow mustaches in `<textarea>` |
+|  | [order-in-components](./docs/rules/order-in-components.md) | enforce order of properties in components |
+| :white_check_mark: | [require-component-is](./docs/rules/require-component-is.md) | require `v-bind:is` of `<component>` elements |
+|  | [require-default-prop](./docs/rules/require-default-prop.md) | require default value for props |
+|  | [require-prop-types](./docs/rules/require-prop-types.md) | require type definitions in props |
+| :white_check_mark: | [require-v-for-key](./docs/rules/require-v-for-key.md) | require `v-bind:key` with `v-for` directives |
+|  | [this-in-template](./docs/rules/this-in-template.md) | enforce usage of `this` in template |
 
 
 ### Stylistic Issues
 
 |    | Rule ID | Description |
 |:---|:--------|:------------|
-| :wrench: | [attribute-hyphenation](./docs/rules/attribute-hyphenation.md) | Define a style for the props casing in templates. |
-|  | [html-quotes](./docs/rules/html-quotes.md) | enforce quotes style of HTML attributes. |
-| :wrench: | [html-self-closing](./docs/rules/html-self-closing.md) | enforce self-closing style. |
-|  | [max-attributes-per-line](./docs/rules/max-attributes-per-line.md) | Define the number of attributes allows per line |
-| :wrench: | [mustache-interpolation-spacing](./docs/rules/mustache-interpolation-spacing.md) | enforce unified spacing in mustache interpolations. |
-| :wrench: | [name-property-casing](./docs/rules/name-property-casing.md) | Requires specific casing for the name property in Vue components |
-| :wrench: | [no-multi-spaces](./docs/rules/no-multi-spaces.md) | This rule warns about the usage of extra whitespaces between attributes |
-| :wrench: | [v-bind-style](./docs/rules/v-bind-style.md) | enforce `v-bind` directive style. |
-| :wrench: | [v-on-style](./docs/rules/v-on-style.md) | enforce `v-on` directive style. |
+| :wrench: | [attribute-hyphenation](./docs/rules/attribute-hyphenation.md) | enforce attribute naming style in template |
+|  | [html-quotes](./docs/rules/html-quotes.md) | enforce quotes style of HTML attributes |
+| :wrench: | [html-self-closing](./docs/rules/html-self-closing.md) | enforce self-closing style |
+|  | [max-attributes-per-line](./docs/rules/max-attributes-per-line.md) | enforce the maximum number of attributes per line |
+| :wrench: | [mustache-interpolation-spacing](./docs/rules/mustache-interpolation-spacing.md) | enforce unified spacing in mustache interpolations |
+| :wrench: | [name-property-casing](./docs/rules/name-property-casing.md) | enforce specific casing for the name property in Vue components |
+| :wrench: | [no-multi-spaces](./docs/rules/no-multi-spaces.md) | disallow multiple spaces |
+| :wrench: | [v-bind-style](./docs/rules/v-bind-style.md) | enforce `v-bind` directive style |
+| :wrench: | [v-on-style](./docs/rules/v-on-style.md) | enforce `v-on` directive style |
 
 
 ### Variables
 
 |    | Rule ID | Description |
 |:---|:--------|:------------|
-| :white_check_mark: | [jsx-uses-vars](./docs/rules/jsx-uses-vars.md) | Prevent variables used in JSX to be marked as unused |
+| :white_check_mark: | [jsx-uses-vars](./docs/rules/jsx-uses-vars.md) | prevent variables used in JSX to be marked as unused |
 
 ### Deprecated
 
@@ -162,22 +162,22 @@ The `--fix` option on the command line automatically fixes problems reported by
 
 | Rule ID | Replaced by |
 |:--------|:------------|
-| [html-no-self-closing](./rules/html-no-self-closing.md) | [html-self-closing-style](./rules/html-self-closing-style.md) |
-| [no-invalid-template-root](./rules/no-invalid-template-root.md) | [valid-template-root](./rules/valid-template-root.md) |
-| [no-invalid-v-bind](./rules/no-invalid-v-bind.md) | [valid-v-bind](./rules/valid-v-bind.md) |
-| [no-invalid-v-cloak](./rules/no-invalid-v-cloak.md) | [valid-v-cloak](./rules/valid-v-cloak.md) |
-| [no-invalid-v-else-if](./rules/no-invalid-v-else-if.md) | [valid-v-else-if](./rules/valid-v-else-if.md) |
-| [no-invalid-v-else](./rules/no-invalid-v-else.md) | [valid-v-else](./rules/valid-v-else.md) |
-| [no-invalid-v-for](./rules/no-invalid-v-for.md) | [valid-v-for](./rules/valid-v-for.md) |
-| [no-invalid-v-html](./rules/no-invalid-v-html.md) | [valid-v-html](./rules/valid-v-html.md) |
-| [no-invalid-v-if](./rules/no-invalid-v-if.md) | [valid-v-if](./rules/valid-v-if.md) |
-| [no-invalid-v-model](./rules/no-invalid-v-model.md) | [valid-v-model](./rules/valid-v-model.md) |
-| [no-invalid-v-on](./rules/no-invalid-v-on.md) | [valid-v-on](./rules/valid-v-on.md) |
-| [no-invalid-v-once](./rules/no-invalid-v-once.md) | [valid-v-once](./rules/valid-v-once.md) |
-| [no-invalid-v-pre](./rules/no-invalid-v-pre.md) | [valid-v-pre](./rules/valid-v-pre.md) |
-| [no-invalid-v-show](./rules/no-invalid-v-show.md) | [valid-v-show](./rules/valid-v-show.md) |
-| [no-invalid-v-text](./rules/no-invalid-v-text.md) | [valid-v-text](./rules/valid-v-text.md) |
-| [no-reservered-keys](./rules/no-reservered-keys.md) | [no-reserved-keys](./rules/no-reserved-keys.md) |
+| [html-no-self-closing](./docs/rules/html-no-self-closing.md) | [html-self-closing](./docs/rules/html-self-closing.md) |
+| [no-invalid-template-root](./docs/rules/no-invalid-template-root.md) | [valid-template-root](./docs/rules/valid-template-root.md) |
+| [no-invalid-v-bind](./docs/rules/no-invalid-v-bind.md) | [valid-v-bind](./docs/rules/valid-v-bind.md) |
+| [no-invalid-v-cloak](./docs/rules/no-invalid-v-cloak.md) | [valid-v-cloak](./docs/rules/valid-v-cloak.md) |
+| [no-invalid-v-else-if](./docs/rules/no-invalid-v-else-if.md) | [valid-v-else-if](./docs/rules/valid-v-else-if.md) |
+| [no-invalid-v-else](./docs/rules/no-invalid-v-else.md) | [valid-v-else](./docs/rules/valid-v-else.md) |
+| [no-invalid-v-for](./docs/rules/no-invalid-v-for.md) | [valid-v-for](./docs/rules/valid-v-for.md) |
+| [no-invalid-v-html](./docs/rules/no-invalid-v-html.md) | [valid-v-html](./docs/rules/valid-v-html.md) |
+| [no-invalid-v-if](./docs/rules/no-invalid-v-if.md) | [valid-v-if](./docs/rules/valid-v-if.md) |
+| [no-invalid-v-model](./docs/rules/no-invalid-v-model.md) | [valid-v-model](./docs/rules/valid-v-model.md) |
+| [no-invalid-v-on](./docs/rules/no-invalid-v-on.md) | [valid-v-on](./docs/rules/valid-v-on.md) |
+| [no-invalid-v-once](./docs/rules/no-invalid-v-once.md) | [valid-v-once](./docs/rules/valid-v-once.md) |
+| [no-invalid-v-pre](./docs/rules/no-invalid-v-pre.md) | [valid-v-pre](./docs/rules/valid-v-pre.md) |
+| [no-invalid-v-show](./docs/rules/no-invalid-v-show.md) | [valid-v-show](./docs/rules/valid-v-show.md) |
+| [no-invalid-v-text](./docs/rules/no-invalid-v-text.md) | [valid-v-text](./docs/rules/valid-v-text.md) |
+| [no-reservered-keys](./docs/rules/no-reservered-keys.md) | [no-reserved-keys](./docs/rules/no-reserved-keys.md) |
 
 <!--RULES_TABLE_END-->
 
diff --git a/docs/rules/attribute-hyphenation.md b/docs/rules/attribute-hyphenation.md
index 7d83c9fad..0028c2a58 100644
--- a/docs/rules/attribute-hyphenation.md
+++ b/docs/rules/attribute-hyphenation.md
@@ -1,4 +1,6 @@
-# Define if attributes on cusom components can be hyphened. (attribute-hyphenation)
+# enforce attribute naming style in template (attribute-hyphenation)
+
+- :wrench: The `--fix` option on the [command line](http://eslint.org/docs/user-guide/command-line-interface#fix) can automatically fix some of the problems reported by this rule.
 
 ## :wrench: Options
 
diff --git a/docs/rules/html-end-tags.md b/docs/rules/html-end-tags.md
index 75803f768..059fc3fed 100644
--- a/docs/rules/html-end-tags.md
+++ b/docs/rules/html-end-tags.md
@@ -1,6 +1,6 @@
-# Enforce end tag style (html-end-tags)
+# enforce end tag style (html-end-tags)
 
-- :wrench: This rule is fixable with `eslint --fix` command.
+- :wrench: The `--fix` option on the [command line](http://eslint.org/docs/user-guide/command-line-interface#fix) can automatically fix some of the problems reported by this rule.
 
 This rule enforce the way of end tags.
 
diff --git a/docs/rules/html-no-self-closing.md b/docs/rules/html-no-self-closing.md
index 37967e82b..bda6e3328 100644
--- a/docs/rules/html-no-self-closing.md
+++ b/docs/rules/html-no-self-closing.md
@@ -1,6 +1,7 @@
-# Disallow self-closing elements (html-no-self-closing)
+# disallow self-closing elements (html-no-self-closing)
 
-- :wrench: This rule is fixable with `eslint --fix` command.
+- :warning: This rule was **deprecated** and replaced by [html-self-closing](html-self-closing.md) rule.
+- :wrench: The `--fix` option on the [command line](http://eslint.org/docs/user-guide/command-line-interface#fix) can automatically fix some of the problems reported by this rule.
 
 Self-closing (e.g. `<br/>`) is syntax of XML/XHTML.
 HTML ignores it.
diff --git a/docs/rules/html-quotes.md b/docs/rules/html-quotes.md
index 920f5b6be..89603e594 100644
--- a/docs/rules/html-quotes.md
+++ b/docs/rules/html-quotes.md
@@ -1,4 +1,4 @@
-# Enforce quotes style of HTML attributes (html-quotes)
+# enforce quotes style of HTML attributes (html-quotes)
 
 You can choose quotes of HTML attributes from:
 
diff --git a/docs/rules/html-self-closing.md b/docs/rules/html-self-closing.md
index c7ac3822f..2a89d6732 100644
--- a/docs/rules/html-self-closing.md
+++ b/docs/rules/html-self-closing.md
@@ -1,4 +1,6 @@
-# Enforce self-closing style (html-self-closing)
+# enforce self-closing style (html-self-closing)
+
+- :wrench: The `--fix` option on the [command line](http://eslint.org/docs/user-guide/command-line-interface#fix) can automatically fix some of the problems reported by this rule.
 
 In Vue.js template, we can use either two styles for elements which don't have their content.
 
diff --git a/docs/rules/jsx-uses-vars.md b/docs/rules/jsx-uses-vars.md
index 3e0a2068b..1d9a4df94 100644
--- a/docs/rules/jsx-uses-vars.md
+++ b/docs/rules/jsx-uses-vars.md
@@ -1,4 +1,6 @@
-# Prevent variables used in JSX to be marked as unused (jsx-uses-vars)
+# prevent variables used in JSX to be marked as unused (jsx-uses-vars)
+
+- :white_check_mark: The `"extends": "plugin:vue/recommended"` property in a configuration file enables this rule.
 
 Since 0.17.0 the ESLint `no-unused-vars` rule does not detect variables used in JSX ([see details](http://eslint.org/blog/2015/03/eslint-0.17.0-released#changes-to-jsxreact-handling)).
 This rule will find variables used in JSX and mark them as used.
diff --git a/docs/rules/max-attributes-per-line.md b/docs/rules/max-attributes-per-line.md
index 8493465b6..11118ee18 100644
--- a/docs/rules/max-attributes-per-line.md
+++ b/docs/rules/max-attributes-per-line.md
@@ -1,4 +1,4 @@
-# Define the number of attributes allows per line (max-attributes-per-line)
+# enforce the maximum number of attributes per line (max-attributes-per-line)
 
 Limits the maximum number of attributes/properties per line to improve readability.
 
diff --git a/docs/rules/mustache-interpolation-spacing.md b/docs/rules/mustache-interpolation-spacing.md
index 4844d15ab..fcb385891 100644
--- a/docs/rules/mustache-interpolation-spacing.md
+++ b/docs/rules/mustache-interpolation-spacing.md
@@ -1,4 +1,4 @@
-# enforce unified spacing in mustache interpolations. (mustache-interpolation-spacing)
+# enforce unified spacing in mustache interpolations (mustache-interpolation-spacing)
 
 - :wrench: The `--fix` option on the [command line](http://eslint.org/docs/user-guide/command-line-interface#fix) can automatically fix some of the problems reported by this rule.
 
diff --git a/docs/rules/name-property-casing.md b/docs/rules/name-property-casing.md
index 316cda8f3..648935b58 100644
--- a/docs/rules/name-property-casing.md
+++ b/docs/rules/name-property-casing.md
@@ -1,4 +1,6 @@
-# Requires specific casing for the name property in Vue components (name-property-casing)
+# enforce specific casing for the name property in Vue components (name-property-casing)
+
+- :wrench: The `--fix` option on the [command line](http://eslint.org/docs/user-guide/command-line-interface#fix) can automatically fix some of the problems reported by this rule.
 
 Define a style for the `name` property casing for consistency purposes.
 
diff --git a/docs/rules/no-async-in-computed-properties.md b/docs/rules/no-async-in-computed-properties.md
index 83c48b59e..4fd8790a3 100644
--- a/docs/rules/no-async-in-computed-properties.md
+++ b/docs/rules/no-async-in-computed-properties.md
@@ -1,4 +1,4 @@
-# Check if there are no asynchronous actions inside computed properties (no-async-in-computed-properties)
+# disallow asynchronous actions in computed properties (no-async-in-computed-properties)
 
 Computed properties should be synchronous. Asynchronous actions inside them may not work as expected and can lead to an unexpected behaviour, that's why you should avoid them.
 If you need async computed properties you might want to consider using additional plugin [vue-async-computed]
diff --git a/docs/rules/no-confusing-v-for-v-if.md b/docs/rules/no-confusing-v-for-v-if.md
index 04779f451..929b1b446 100644
--- a/docs/rules/no-confusing-v-for-v-if.md
+++ b/docs/rules/no-confusing-v-for-v-if.md
@@ -1,4 +1,6 @@
-# Disallow confusing `v-for` and `v-if` on the same element (no-confusing-v-for-v-if)
+# disallow confusing `v-for` and `v-if` on the same element (no-confusing-v-for-v-if)
+
+- :white_check_mark: The `"extends": "plugin:vue/recommended"` property in a configuration file enables this rule.
 
 > When they exist on the same node, `v-for` has a higher priority than `v-if`. That means the `v-if` will be run on each iteration of the loop separately.
 >
diff --git a/docs/rules/no-dupe-keys.md b/docs/rules/no-dupe-keys.md
index 990001881..983b45550 100644
--- a/docs/rules/no-dupe-keys.md
+++ b/docs/rules/no-dupe-keys.md
@@ -1,4 +1,4 @@
-# Prevents duplication of field names (no-dupe-keys)
+# disallow duplication of field names (no-dupe-keys)
 
 This rule prevents to use duplicated names.
 
diff --git a/docs/rules/no-duplicate-attributes.md b/docs/rules/no-duplicate-attributes.md
index 3cf820de6..db9204a32 100644
--- a/docs/rules/no-duplicate-attributes.md
+++ b/docs/rules/no-duplicate-attributes.md
@@ -1,4 +1,4 @@
-# Disallow duplicate arguments (no-duplicate-attributes)
+# disallow duplication of attributes (no-duplicate-attributes)
 
 When duplicate arguments exist, only the last one is valid.
 It's possibly mistakes.
diff --git a/docs/rules/no-invalid-template-root.md b/docs/rules/no-invalid-template-root.md
index 6c9ca8773..d154097ea 100644
--- a/docs/rules/no-invalid-template-root.md
+++ b/docs/rules/no-invalid-template-root.md
@@ -1,4 +1,6 @@
-# Disallow invalid template root (no-invalid-root-element)
+# disallow invalid template root (no-invalid-template-root)
+
+- :warning: This rule was **deprecated** and replaced by [valid-template-root](valid-template-root.md) rule.
 
 This rule checks whether every template root is valid.
 
diff --git a/docs/rules/no-invalid-v-bind.md b/docs/rules/no-invalid-v-bind.md
index 96914cc3a..c820e14fe 100644
--- a/docs/rules/no-invalid-v-bind.md
+++ b/docs/rules/no-invalid-v-bind.md
@@ -1,4 +1,6 @@
-# Disallow invalid `v-bind` directives (no-invalid-v-bind)
+# disallow invalid `v-bind` directives (no-invalid-v-bind)
+
+- :warning: This rule was **deprecated** and replaced by [valid-v-bind](valid-v-bind.md) rule.
 
 This rule checks whether every `v-bind` directive is valid.
 
diff --git a/docs/rules/no-invalid-v-cloak.md b/docs/rules/no-invalid-v-cloak.md
index 8b717f780..931b8eeec 100644
--- a/docs/rules/no-invalid-v-cloak.md
+++ b/docs/rules/no-invalid-v-cloak.md
@@ -1,4 +1,6 @@
-# Disallow invalid `v-cloak` directives (no-invalid-v-cloak)
+# disallow invalid `v-cloak` directives (no-invalid-v-cloak)
+
+- :warning: This rule was **deprecated** and replaced by [valid-v-cloak](valid-v-cloak.md) rule.
 
 This rule checks whether every `v-cloak` directive is valid.
 
diff --git a/docs/rules/no-invalid-v-else-if.md b/docs/rules/no-invalid-v-else-if.md
index b8125a8a8..e724f7fec 100644
--- a/docs/rules/no-invalid-v-else-if.md
+++ b/docs/rules/no-invalid-v-else-if.md
@@ -1,4 +1,6 @@
-# Disallow invalid `v-else-if` directives (no-invalid-v-else-if)
+# disallow invalid `v-else-if` directives (no-invalid-v-else-if)
+
+- :warning: This rule was **deprecated** and replaced by [valid-v-else-if](valid-v-else-if.md) rule.
 
 This rule checks whether every `v-else-if` directive is valid.
 
diff --git a/docs/rules/no-invalid-v-else.md b/docs/rules/no-invalid-v-else.md
index 912dd4893..82c2cc17d 100644
--- a/docs/rules/no-invalid-v-else.md
+++ b/docs/rules/no-invalid-v-else.md
@@ -1,4 +1,6 @@
-# Disallow invalid `v-else` directives (no-invalid-v-else)
+# disallow invalid `v-else` directives (no-invalid-v-else)
+
+- :warning: This rule was **deprecated** and replaced by [valid-v-else](valid-v-else.md) rule.
 
 This rule checks whether every `v-else` directive is valid.
 
diff --git a/docs/rules/no-invalid-v-for.md b/docs/rules/no-invalid-v-for.md
index f1b78848e..4953d3b3e 100644
--- a/docs/rules/no-invalid-v-for.md
+++ b/docs/rules/no-invalid-v-for.md
@@ -1,4 +1,6 @@
-# Disallow invalid `v-for` directives (no-invalid-v-for)
+# disallow invalid `v-for` directives (no-invalid-v-for)
+
+- :warning: This rule was **deprecated** and replaced by [valid-v-for](valid-v-for.md) rule.
 
 This rule checks whether every `v-for` directive is valid.
 
diff --git a/docs/rules/no-invalid-v-html.md b/docs/rules/no-invalid-v-html.md
index be377165a..370ad818f 100644
--- a/docs/rules/no-invalid-v-html.md
+++ b/docs/rules/no-invalid-v-html.md
@@ -1,4 +1,6 @@
-# Disallow invalid `v-html` directives (no-invalid-v-html)
+# disallow invalid `v-html` directives (no-invalid-v-html)
+
+- :warning: This rule was **deprecated** and replaced by [valid-v-html](valid-v-html.md) rule.
 
 This rule checks whether every `v-html` directive is valid.
 
diff --git a/docs/rules/no-invalid-v-if.md b/docs/rules/no-invalid-v-if.md
index c76bdd71f..99cabc5a2 100644
--- a/docs/rules/no-invalid-v-if.md
+++ b/docs/rules/no-invalid-v-if.md
@@ -1,4 +1,6 @@
-# Disallow invalid `v-if` directives (no-invalid-v-if)
+# disallow invalid `v-if` directives (no-invalid-v-if)
+
+- :warning: This rule was **deprecated** and replaced by [valid-v-if](valid-v-if.md) rule.
 
 This rule checks whether every `v-if` directive is valid.
 
diff --git a/docs/rules/no-invalid-v-model.md b/docs/rules/no-invalid-v-model.md
index 752e312c3..281cdfaf9 100644
--- a/docs/rules/no-invalid-v-model.md
+++ b/docs/rules/no-invalid-v-model.md
@@ -1,4 +1,6 @@
-# Disallow invalid `v-model` directives (no-invalid-v-model)
+# disallow invalid `v-model` directives (no-invalid-v-model)
+
+- :warning: This rule was **deprecated** and replaced by [valid-v-model](valid-v-model.md) rule.
 
 This rule checks whether every `v-model` directive is valid.
 
diff --git a/docs/rules/no-invalid-v-on.md b/docs/rules/no-invalid-v-on.md
index 9e3a0439c..85aff4d0e 100644
--- a/docs/rules/no-invalid-v-on.md
+++ b/docs/rules/no-invalid-v-on.md
@@ -1,4 +1,6 @@
-# Disallow invalid `v-on` directives (no-invalid-v-on)
+# disallow invalid `v-on` directives (no-invalid-v-on)
+
+- :warning: This rule was **deprecated** and replaced by [valid-v-on](valid-v-on.md) rule.
 
 This rule checks whether every `v-on` directive is valid.
 
diff --git a/docs/rules/no-invalid-v-once.md b/docs/rules/no-invalid-v-once.md
index bcb976355..605da17a7 100644
--- a/docs/rules/no-invalid-v-once.md
+++ b/docs/rules/no-invalid-v-once.md
@@ -1,4 +1,6 @@
-# Disallow invalid `v-once` directives (no-invalid-v-once)
+# disallow invalid `v-once` directives (no-invalid-v-once)
+
+- :warning: This rule was **deprecated** and replaced by [valid-v-once](valid-v-once.md) rule.
 
 This rule checks whether every `v-once` directive is valid.
 
diff --git a/docs/rules/no-invalid-v-pre.md b/docs/rules/no-invalid-v-pre.md
index 58fca0e90..514df58f2 100644
--- a/docs/rules/no-invalid-v-pre.md
+++ b/docs/rules/no-invalid-v-pre.md
@@ -1,4 +1,6 @@
-# Disallow invalid `v-pre` directives (no-invalid-v-pre)
+# disallow invalid `v-pre` directives (no-invalid-v-pre)
+
+- :warning: This rule was **deprecated** and replaced by [valid-v-pre](valid-v-pre.md) rule.
 
 This rule checks whether every `v-pre` directive is valid.
 
diff --git a/docs/rules/no-invalid-v-show.md b/docs/rules/no-invalid-v-show.md
index cb63bbefa..a6513f04e 100644
--- a/docs/rules/no-invalid-v-show.md
+++ b/docs/rules/no-invalid-v-show.md
@@ -1,4 +1,6 @@
-# Disallow invalid `v-show` directives (no-invalid-v-show)
+# disallow invalid `v-show` directives (no-invalid-v-show)
+
+- :warning: This rule was **deprecated** and replaced by [valid-v-show](valid-v-show.md) rule.
 
 This rule checks whether every `v-show` directive is valid.
 
diff --git a/docs/rules/no-invalid-v-text.md b/docs/rules/no-invalid-v-text.md
index 36c98e015..627a8ecdf 100644
--- a/docs/rules/no-invalid-v-text.md
+++ b/docs/rules/no-invalid-v-text.md
@@ -1,4 +1,6 @@
-# Disallow invalid `v-text` directives (no-invalid-v-text)
+# disallow invalid `v-text` directives (no-invalid-v-text)
+
+- :warning: This rule was **deprecated** and replaced by [valid-v-text](valid-v-text.md) rule.
 
 This rule checks whether every `v-text` directive is valid.
 
diff --git a/docs/rules/no-multi-spaces.md b/docs/rules/no-multi-spaces.md
index b93254dab..c098248d5 100644
--- a/docs/rules/no-multi-spaces.md
+++ b/docs/rules/no-multi-spaces.md
@@ -1,4 +1,6 @@
-# This rule warns about the usage of extra whitespaces between attributes (no-multi-spaces)
+# disallow multiple spaces (no-multi-spaces)
+
+- :wrench: The `--fix` option on the [command line](http://eslint.org/docs/user-guide/command-line-interface#fix) can automatically fix some of the problems reported by this rule.
 
 The `--fix` option on the command line can automatically fix some of the problems reported by this rule.
 
diff --git a/docs/rules/no-parsing-error.md b/docs/rules/no-parsing-error.md
index ccdb44b3f..6770b5da1 100644
--- a/docs/rules/no-parsing-error.md
+++ b/docs/rules/no-parsing-error.md
@@ -1,4 +1,6 @@
-# Disallow parsing errors in `<template>` (no-parsing-error)
+# disallow parsing errors in `<template>` (no-parsing-error)
+
+- :white_check_mark: The `"extends": "plugin:vue/recommended"` property in a configuration file enables this rule.
 
 This rule reports syntax errors in `<template>`. For example:
 
diff --git a/docs/rules/no-reserved-keys.md b/docs/rules/no-reserved-keys.md
index baf54a6a4..32568d0ac 100644
--- a/docs/rules/no-reserved-keys.md
+++ b/docs/rules/no-reserved-keys.md
@@ -1,4 +1,4 @@
-# Prevent overwrite reserved keys (no-reserved-keys)
+# disallow overwriting reserved keys (no-reserved-keys)
 
 This rule prevents to use reserved names from to avoid conflicts and unexpected behavior.
 
diff --git a/docs/rules/no-reservered-keys.md b/docs/rules/no-reservered-keys.md
index 4ec1aaa1f..3439907a0 100644
--- a/docs/rules/no-reservered-keys.md
+++ b/docs/rules/no-reservered-keys.md
@@ -1,4 +1,6 @@
-# Prevent overwrite reserved keys (no-reservered-keys)
+# disallow overwriting reserved keys (no-reservered-keys)
+
+- :warning: This rule was **deprecated** and replaced by [no-reserved-keys](no-reserved-keys.md) rule.
 
 This rule prevents to use reserved names from to avoid conflicts and unexpected behavior.
 
diff --git a/docs/rules/no-shared-component-data.md b/docs/rules/no-shared-component-data.md
index 093b502f9..836eea109 100644
--- a/docs/rules/no-shared-component-data.md
+++ b/docs/rules/no-shared-component-data.md
@@ -1,4 +1,4 @@
-# Enforces component's data property to be a function (no-shared-component-data)
+# enforce component's data property to be a function (no-shared-component-data)
 
 When using the data property on a component (i.e. anywhere except on `new Vue`), the value must be a function that returns an object.
 
diff --git a/docs/rules/no-side-effects-in-computed-properties.md b/docs/rules/no-side-effects-in-computed-properties.md
index d908435f0..5a7ff8aec 100644
--- a/docs/rules/no-side-effects-in-computed-properties.md
+++ b/docs/rules/no-side-effects-in-computed-properties.md
@@ -1,4 +1,4 @@
-# Do not introduce side effects in computed properties (no-side-effects-in-computed-properties)
+# disallow side effects in computed properties (no-side-effects-in-computed-properties)
 
 It is considered a very bad practice to introduce side effects inside computed properties. It makes the code not predictable and hard to understand.
 
diff --git a/docs/rules/no-template-key.md b/docs/rules/no-template-key.md
index cc04d2417..d0d1eca8d 100644
--- a/docs/rules/no-template-key.md
+++ b/docs/rules/no-template-key.md
@@ -1,4 +1,4 @@
-# Disallow `key` attribute on `<template>` (no-template-key)
+# disallow `key` attribute on `<template>` (no-template-key)
 
 Vue.js disallows `key` attribute on `<template>` elements.
 
diff --git a/docs/rules/no-textarea-mustache.md b/docs/rules/no-textarea-mustache.md
index 7499c69aa..14a2ee54c 100644
--- a/docs/rules/no-textarea-mustache.md
+++ b/docs/rules/no-textarea-mustache.md
@@ -1,4 +1,6 @@
-# Disallow mustaches in `<textarea>` (no-textarea-mustache)
+# disallow mustaches in `<textarea>` (no-textarea-mustache)
+
+- :white_check_mark: The `"extends": "plugin:vue/recommended"` property in a configuration file enables this rule.
 
 > Interpolation on textareas (`<textarea>{{text}}</textarea>`) won't work. Use `v-model` instead.
 >
diff --git a/docs/rules/order-in-components.md b/docs/rules/order-in-components.md
index 6156f2af8..d246eb1b0 100644
--- a/docs/rules/order-in-components.md
+++ b/docs/rules/order-in-components.md
@@ -1,4 +1,4 @@
-# Keep proper order of properties in your `components` (order-in-components)
+# enforce order of properties in components (order-in-components)
 
 This rule makes sure you keep declared order of properties in components.
 
diff --git a/docs/rules/require-component-is.md b/docs/rules/require-component-is.md
index 278ce778c..41fe9b23d 100644
--- a/docs/rules/require-component-is.md
+++ b/docs/rules/require-component-is.md
@@ -1,4 +1,6 @@
-# Require `v-bind:is` of `<component>` elements (require-component-is)
+# require `v-bind:is` of `<component>` elements (require-component-is)
+
+- :white_check_mark: The `"extends": "plugin:vue/recommended"` property in a configuration file enables this rule.
 
 > You can use the same mount point and dynamically switch between multiple components using the reserved `<component>` element and dynamically bind to its `is` attribute:
 >
diff --git a/docs/rules/require-default-prop.md b/docs/rules/require-default-prop.md
index e7b9446ac..08fb9db09 100644
--- a/docs/rules/require-default-prop.md
+++ b/docs/rules/require-default-prop.md
@@ -1,4 +1,4 @@
-# Require default value for props (require-default-prop)
+# require default value for props (require-default-prop)
 
 This rule requires default value to be set for each props that are not marked as `required`.
 
diff --git a/docs/rules/require-prop-types.md b/docs/rules/require-prop-types.md
index 4c0c0c465..3236d74a2 100644
--- a/docs/rules/require-prop-types.md
+++ b/docs/rules/require-prop-types.md
@@ -1,4 +1,4 @@
-# Prop definitions should be detailed (require-prop-types)
+# require type definitions in props (require-prop-types)
 
 In committed code, prop definitions should always be as detailed as possible, specifying at least type(s).
 
diff --git a/docs/rules/require-render-return.md b/docs/rules/require-render-return.md
index 44ea2d820..ffbb374d0 100644
--- a/docs/rules/require-render-return.md
+++ b/docs/rules/require-render-return.md
@@ -1,4 +1,4 @@
-# Enforces render function to always return value (require-render-return)
+# enforce render function to always return value (require-render-return)
 
 This rule aims to enforce render function to always return value
 
diff --git a/docs/rules/require-v-for-key.md b/docs/rules/require-v-for-key.md
index 24672e12c..9db96c330 100644
--- a/docs/rules/require-v-for-key.md
+++ b/docs/rules/require-v-for-key.md
@@ -1,4 +1,6 @@
-# Require `v-bind:key` with `v-for` directives (require-v-for-key)
+# require `v-bind:key` with `v-for` directives (require-v-for-key)
+
+- :white_check_mark: The `"extends": "plugin:vue/recommended"` property in a configuration file enables this rule.
 
 When `v-for` is written on custom components, it requires `v-bind:key` at the same time.
 On other elements, it's better that `v-bind:key` is written as well.
diff --git a/docs/rules/require-valid-default-prop.md b/docs/rules/require-valid-default-prop.md
index a571ecf33..81b3aac8a 100644
--- a/docs/rules/require-valid-default-prop.md
+++ b/docs/rules/require-valid-default-prop.md
@@ -1,4 +1,4 @@
-# Enforces props default values to be valid (require-valid-default-prop)
+# enforce props default values to be valid (require-valid-default-prop)
 
 This rule checks whether the default value of each prop is valid for the given type. It should report an error when default value for type `Array` or `Object` is not returned using function.
 
diff --git a/docs/rules/return-in-computed-property.md b/docs/rules/return-in-computed-property.md
index 5f66d08b0..f4e20fcab 100644
--- a/docs/rules/return-in-computed-property.md
+++ b/docs/rules/return-in-computed-property.md
@@ -1,4 +1,4 @@
-# Enforces that a return statement is present in computed property (return-in-computed-property)
+# enforce that a return statement is present in computed property (return-in-computed-property)
 
 ## :book: Rule Details
 
diff --git a/docs/rules/this-in-template.md b/docs/rules/this-in-template.md
index 81886ba1c..037bbe0ed 100644
--- a/docs/rules/this-in-template.md
+++ b/docs/rules/this-in-template.md
@@ -1,4 +1,4 @@
-# enforce usage of `this` in template. (this-in-template)
+# enforce usage of `this` in template (this-in-template)
 
 ## :book: Rule Details
 
diff --git a/docs/rules/v-bind-style.md b/docs/rules/v-bind-style.md
index 920023355..1375306bc 100644
--- a/docs/rules/v-bind-style.md
+++ b/docs/rules/v-bind-style.md
@@ -1,6 +1,6 @@
-# Enforce v-bind directive style (v-bind-style)
+# enforce `v-bind` directive style (v-bind-style)
 
-- :wrench: This rule is fixable with `eslint --fix` command.
+- :wrench: The `--fix` option on the [command line](http://eslint.org/docs/user-guide/command-line-interface#fix) can automatically fix some of the problems reported by this rule.
 
 This rule enforces `v-bind` directive style which you should use shorthand or long form.
 
diff --git a/docs/rules/v-on-style.md b/docs/rules/v-on-style.md
index 3ef01677b..144ee12b7 100644
--- a/docs/rules/v-on-style.md
+++ b/docs/rules/v-on-style.md
@@ -1,6 +1,6 @@
-# Enforce v-on directive style (v-on-style)
+# enforce `v-on` directive style (v-on-style)
 
-- :wrench: This rule is fixable with `eslint --fix` command.
+- :wrench: The `--fix` option on the [command line](http://eslint.org/docs/user-guide/command-line-interface#fix) can automatically fix some of the problems reported by this rule.
 
 This rule enforces `v-on` directive style which you should use shorthand or long form.
 
diff --git a/docs/rules/valid-template-root.md b/docs/rules/valid-template-root.md
index 2ac866452..bde86b40a 100644
--- a/docs/rules/valid-template-root.md
+++ b/docs/rules/valid-template-root.md
@@ -1,4 +1,6 @@
-# Enforce valid template root (valid-root-element)
+# enforce valid template root (valid-template-root)
+
+- :white_check_mark: The `"extends": "plugin:vue/recommended"` property in a configuration file enables this rule.
 
 This rule checks whether every template root is valid.
 
diff --git a/docs/rules/valid-v-bind.md b/docs/rules/valid-v-bind.md
index ca165b1bb..bcb01ed2e 100644
--- a/docs/rules/valid-v-bind.md
+++ b/docs/rules/valid-v-bind.md
@@ -1,4 +1,6 @@
-# Enforce valid `v-bind` directives (valid-v-bind)
+# enforce valid `v-bind` directives (valid-v-bind)
+
+- :white_check_mark: The `"extends": "plugin:vue/recommended"` property in a configuration file enables this rule.
 
 This rule checks whether every `v-bind` directive is valid.
 
diff --git a/docs/rules/valid-v-cloak.md b/docs/rules/valid-v-cloak.md
index 196be2173..b0905c3d4 100644
--- a/docs/rules/valid-v-cloak.md
+++ b/docs/rules/valid-v-cloak.md
@@ -1,4 +1,6 @@
-# Enforce valid `v-cloak` directives (valid-v-cloak)
+# enforce valid `v-cloak` directives (valid-v-cloak)
+
+- :white_check_mark: The `"extends": "plugin:vue/recommended"` property in a configuration file enables this rule.
 
 This rule checks whether every `v-cloak` directive is valid.
 
diff --git a/docs/rules/valid-v-else-if.md b/docs/rules/valid-v-else-if.md
index 820e9f90d..83916b7bd 100644
--- a/docs/rules/valid-v-else-if.md
+++ b/docs/rules/valid-v-else-if.md
@@ -1,4 +1,6 @@
-# Enforce valid `v-else-if` directives (valid-v-else-if)
+# enforce valid `v-else-if` directives (valid-v-else-if)
+
+- :white_check_mark: The `"extends": "plugin:vue/recommended"` property in a configuration file enables this rule.
 
 This rule checks whether every `v-else-if` directive is valid.
 
diff --git a/docs/rules/valid-v-else.md b/docs/rules/valid-v-else.md
index 690ec6c7a..f9e849a98 100644
--- a/docs/rules/valid-v-else.md
+++ b/docs/rules/valid-v-else.md
@@ -1,4 +1,6 @@
-# Enforce valid `v-else` directives (valid-v-else)
+# enforce valid `v-else` directives (valid-v-else)
+
+- :white_check_mark: The `"extends": "plugin:vue/recommended"` property in a configuration file enables this rule.
 
 This rule checks whether every `v-else` directive is valid.
 
diff --git a/docs/rules/valid-v-for.md b/docs/rules/valid-v-for.md
index 46cadeb8f..59d05bda5 100644
--- a/docs/rules/valid-v-for.md
+++ b/docs/rules/valid-v-for.md
@@ -1,4 +1,6 @@
-# Enforce valid `v-for` directives (valid-v-for)
+# enforce valid `v-for` directives (valid-v-for)
+
+- :white_check_mark: The `"extends": "plugin:vue/recommended"` property in a configuration file enables this rule.
 
 This rule checks whether every `v-for` directive is valid.
 
diff --git a/docs/rules/valid-v-html.md b/docs/rules/valid-v-html.md
index 3a703e471..1967bbe7a 100644
--- a/docs/rules/valid-v-html.md
+++ b/docs/rules/valid-v-html.md
@@ -1,4 +1,6 @@
-# Enforce valid `v-html` directives (valid-v-html)
+# enforce valid `v-html` directives (valid-v-html)
+
+- :white_check_mark: The `"extends": "plugin:vue/recommended"` property in a configuration file enables this rule.
 
 This rule checks whether every `v-html` directive is valid.
 
diff --git a/docs/rules/valid-v-if.md b/docs/rules/valid-v-if.md
index 73c159148..bee8ab638 100644
--- a/docs/rules/valid-v-if.md
+++ b/docs/rules/valid-v-if.md
@@ -1,4 +1,6 @@
-# Enforce valid `v-if` directives (valid-v-if)
+# enforce valid `v-if` directives (valid-v-if)
+
+- :white_check_mark: The `"extends": "plugin:vue/recommended"` property in a configuration file enables this rule.
 
 This rule checks whether every `v-if` directive is valid.
 
diff --git a/docs/rules/valid-v-model.md b/docs/rules/valid-v-model.md
index 5f35a480a..1c71de3a8 100644
--- a/docs/rules/valid-v-model.md
+++ b/docs/rules/valid-v-model.md
@@ -1,4 +1,6 @@
-# Enforce valid `v-model` directives (valid-v-model)
+# enforce valid `v-model` directives (valid-v-model)
+
+- :white_check_mark: The `"extends": "plugin:vue/recommended"` property in a configuration file enables this rule.
 
 This rule checks whether every `v-model` directive is valid.
 
diff --git a/docs/rules/valid-v-on.md b/docs/rules/valid-v-on.md
index e88a4d675..df9554444 100644
--- a/docs/rules/valid-v-on.md
+++ b/docs/rules/valid-v-on.md
@@ -1,4 +1,6 @@
-# Enforce valid `v-on` directives (valid-v-on)
+# enforce valid `v-on` directives (valid-v-on)
+
+- :white_check_mark: The `"extends": "plugin:vue/recommended"` property in a configuration file enables this rule.
 
 This rule checks whether every `v-on` directive is valid.
 
diff --git a/docs/rules/valid-v-once.md b/docs/rules/valid-v-once.md
index 0f367555d..40972e39f 100644
--- a/docs/rules/valid-v-once.md
+++ b/docs/rules/valid-v-once.md
@@ -1,4 +1,6 @@
-# Enforce valid `v-once` directives (valid-v-once)
+# enforce valid `v-once` directives (valid-v-once)
+
+- :white_check_mark: The `"extends": "plugin:vue/recommended"` property in a configuration file enables this rule.
 
 This rule checks whether every `v-once` directive is valid.
 
diff --git a/docs/rules/valid-v-pre.md b/docs/rules/valid-v-pre.md
index 7dba0ebc5..26692301e 100644
--- a/docs/rules/valid-v-pre.md
+++ b/docs/rules/valid-v-pre.md
@@ -1,4 +1,6 @@
-# Enforce valid `v-pre` directives (valid-v-pre)
+# enforce valid `v-pre` directives (valid-v-pre)
+
+- :white_check_mark: The `"extends": "plugin:vue/recommended"` property in a configuration file enables this rule.
 
 This rule checks whether every `v-pre` directive is valid.
 
diff --git a/docs/rules/valid-v-show.md b/docs/rules/valid-v-show.md
index 1e2175993..4a7589044 100644
--- a/docs/rules/valid-v-show.md
+++ b/docs/rules/valid-v-show.md
@@ -1,4 +1,6 @@
-# Enforce valid `v-show` directives (valid-v-show)
+# enforce valid `v-show` directives (valid-v-show)
+
+- :white_check_mark: The `"extends": "plugin:vue/recommended"` property in a configuration file enables this rule.
 
 This rule checks whether every `v-show` directive is valid.
 
diff --git a/docs/rules/valid-v-text.md b/docs/rules/valid-v-text.md
index c808e6413..b447705c7 100644
--- a/docs/rules/valid-v-text.md
+++ b/docs/rules/valid-v-text.md
@@ -1,4 +1,6 @@
-# Enforce valid `v-text` directives (valid-v-text)
+# enforce valid `v-text` directives (valid-v-text)
+
+- :white_check_mark: The `"extends": "plugin:vue/recommended"` property in a configuration file enables this rule.
 
 This rule checks whether every `v-text` directive is valid.
 
diff --git a/eslint-internal-rules/.eslintrc.json b/eslint-internal-rules/.eslintrc.json
new file mode 100644
index 000000000..936029a17
--- /dev/null
+++ b/eslint-internal-rules/.eslintrc.json
@@ -0,0 +1,6 @@
+{
+  "rules": {
+    "consistent-docs-description": "error",
+    "no-invalid-meta": "error"
+  }
+}
diff --git a/eslint-internal-rules/consistent-docs-description.js b/eslint-internal-rules/consistent-docs-description.js
new file mode 100644
index 000000000..dc30a5699
--- /dev/null
+++ b/eslint-internal-rules/consistent-docs-description.js
@@ -0,0 +1,138 @@
+/**
+ * @fileoverview Internal rule to enforce meta.docs.description conventions.
+ * @author Vitor Balocco
+ */
+
+'use strict'
+
+const ALLOWED_FIRST_WORDS = [
+  'enforce',
+  'require',
+  'disallow'
+]
+
+// ------------------------------------------------------------------------------
+// Helpers
+// ------------------------------------------------------------------------------
+
+/**
+ * Gets the property of the Object node passed in that has the name specified.
+ *
+ * @param {string} property Name of the property to return.
+ * @param {ASTNode} node The ObjectExpression node.
+ * @returns {ASTNode} The Property node or null if not found.
+ */
+function getPropertyFromObject (property, node) {
+  const properties = node.properties
+
+  for (let i = 0; i < properties.length; i++) {
+    if (properties[i].key.name === property) {
+      return properties[i]
+    }
+  }
+
+  return null
+}
+
+/**
+ * Verifies that the meta.docs.description property follows our internal conventions.
+ *
+ * @param {RuleContext} context The ESLint rule context.
+ * @param {ASTNode} exportsNode ObjectExpression node that the rule exports.
+ * @returns {void}
+ */
+function checkMetaDocsDescription (context, exportsNode) {
+  if (exportsNode.type !== 'ObjectExpression') {
+        // if the exported node is not the correct format, "internal-no-invalid-meta" will already report this.
+    return
+  }
+
+  const metaProperty = getPropertyFromObject('meta', exportsNode)
+  const metaDocs = metaProperty && getPropertyFromObject('docs', metaProperty.value)
+  const metaDocsDescription = metaDocs && getPropertyFromObject('description', metaDocs.value)
+
+  if (!metaDocsDescription) {
+        // if there is no `meta.docs.description` property, "internal-no-invalid-meta" will already report this.
+    return
+  }
+
+  const description = metaDocsDescription.value.value
+
+  if (typeof description !== 'string') {
+    context.report({
+      node: metaDocsDescription.value,
+      message: '`meta.docs.description` should be a string.'
+    })
+    return
+  }
+
+  if (description === '') {
+    context.report({
+      node: metaDocsDescription.value,
+      message: '`meta.docs.description` should not be empty.'
+    })
+    return
+  }
+
+  if (description.indexOf(' ') === 0) {
+    context.report({
+      node: metaDocsDescription.value,
+      message: '`meta.docs.description` should not start with whitespace.'
+    })
+    return
+  }
+
+  const firstWord = description.split(' ')[0]
+
+  if (ALLOWED_FIRST_WORDS.indexOf(firstWord) === -1) {
+    context.report({
+      node: metaDocsDescription.value,
+      message: '`meta.docs.description` should start with one of the following words: {{ allowedWords }}. Started with "{{ firstWord }}" instead.',
+      data: {
+        allowedWords: ALLOWED_FIRST_WORDS.join(', '),
+        firstWord
+      }
+    })
+  }
+
+  if (description.endsWith('.')) {
+    context.report({
+      node: metaDocsDescription.value,
+      message: '`meta.docs.description` should not end with `.`.',
+      fix (fixer) {
+        const pos = metaDocsDescription.range[1] - 2
+        return fixer.removeRange([pos, pos + 1])
+      }
+    })
+  }
+}
+
+// ------------------------------------------------------------------------------
+// Rule Definition
+// ------------------------------------------------------------------------------
+
+module.exports = {
+  meta: {
+    docs: {
+      description: 'enforce correct conventions of `meta.docs.description` property in core rules',
+      category: 'Internal',
+      recommended: false
+    },
+    fixable: 'code',
+    schema: []
+  },
+
+  create (context) {
+    return {
+      AssignmentExpression (node) {
+        if (node.left &&
+            node.right &&
+            node.left.type === 'MemberExpression' &&
+            node.left.object.name === 'module' &&
+            node.left.property.name === 'exports') {
+          checkMetaDocsDescription(context, node.right)
+        }
+      }
+    }
+  }
+}
diff --git a/eslint-internal-rules/no-invalid-meta.js b/eslint-internal-rules/no-invalid-meta.js
new file mode 100644
index 000000000..1550d619f
--- /dev/null
+++ b/eslint-internal-rules/no-invalid-meta.js
@@ -0,0 +1,187 @@
+/**
+ * @fileoverview Internal rule to prevent missing or invalid meta property in core rules.
+ * @author Vitor Balocco
+ */
+
+'use strict'
+
+// ------------------------------------------------------------------------------
+// Helpers
+// ------------------------------------------------------------------------------
+
+/**
+ * Gets the property of the Object node passed in that has the name specified.
+ *
+ * @param {string} property Name of the property to return.
+ * @param {ASTNode} node The ObjectExpression node.
+ * @returns {ASTNode} The Property node or null if not found.
+ */
+function getPropertyFromObject (property, node) {
+  const properties = node.properties
+
+  for (let i = 0; i < properties.length; i++) {
+    if (properties[i].key.name === property) {
+      return properties[i]
+    }
+  }
+
+  return null
+}
+
+/**
+ * Extracts the `meta` property from the ObjectExpression that all rules export.
+ *
+ * @param {ASTNode} exportsNode ObjectExpression node that the rule exports.
+ * @returns {ASTNode} The `meta` Property node or null if not found.
+ */
+function getMetaPropertyFromExportsNode (exportsNode) {
+  return getPropertyFromObject('meta', exportsNode)
+}
+
+/**
+ * Whether this `meta` ObjectExpression has a `docs` property defined or not.
+ *
+ * @param {ASTNode} metaPropertyNode The `meta` ObjectExpression for this rule.
+ * @returns {boolean} `true` if a `docs` property exists.
+ */
+function hasMetaDocs (metaPropertyNode) {
+  return Boolean(getPropertyFromObject('docs', metaPropertyNode.value))
+}
+
+/**
+ * Whether this `meta` ObjectExpression has a `docs.description` property defined or not.
+ *
+ * @param {ASTNode} metaPropertyNode The `meta` ObjectExpression for this rule.
+ * @returns {boolean} `true` if a `docs.description` property exists.
+ */
+function hasMetaDocsDescription (metaPropertyNode) {
+  const metaDocs = getPropertyFromObject('docs', metaPropertyNode.value)
+
+  return metaDocs && getPropertyFromObject('description', metaDocs.value)
+}
+
+/**
+ * Whether this `meta` ObjectExpression has a `docs.category` property defined or not.
+ *
+ * @param {ASTNode} metaPropertyNode The `meta` ObjectExpression for this rule.
+ * @returns {boolean} `true` if a `docs.category` property exists.
+ */
+function hasMetaDocsCategory (metaPropertyNode) {
+  const metaDocs = getPropertyFromObject('docs', metaPropertyNode.value)
+
+  return metaDocs && getPropertyFromObject('category', metaDocs.value)
+}
+
+/**
+ * Whether this `meta` ObjectExpression has a `docs.recommended` property defined or not.
+ *
+ * @param {ASTNode} metaPropertyNode The `meta` ObjectExpression for this rule.
+ * @returns {boolean} `true` if a `docs.recommended` property exists.
+ */
+function hasMetaDocsRecommended (metaPropertyNode) {
+  const metaDocs = getPropertyFromObject('docs', metaPropertyNode.value)
+
+  return metaDocs && getPropertyFromObject('recommended', metaDocs.value)
+}
+
+/**
+ * Whether this `meta` ObjectExpression has a `schema` property defined or not.
+ *
+ * @param {ASTNode} metaPropertyNode The `meta` ObjectExpression for this rule.
+ * @returns {boolean} `true` if a `schema` property exists.
+ */
+function hasMetaSchema (metaPropertyNode) {
+  return getPropertyFromObject('schema', metaPropertyNode.value)
+}
+
+/**
+ * Checks the validity of the meta definition of this rule and reports any errors found.
+ *
+ * @param {RuleContext} context The ESLint rule context.
+ * @param {ASTNode} exportsNode ObjectExpression node that the rule exports.
+ * @param {boolean} ruleIsFixable whether the rule is fixable or not.
+ * @returns {void}
+ */
+function checkMetaValidity (context, exportsNode) {
+  const metaProperty = getMetaPropertyFromExportsNode(exportsNode)
+
+  if (!metaProperty) {
+    context.report(exportsNode, 'Rule is missing a meta property.')
+    return
+  }
+
+  if (!hasMetaDocs(metaProperty)) {
+    context.report(metaProperty, 'Rule is missing a meta.docs property.')
+    return
+  }
+
+  if (!hasMetaDocsDescription(metaProperty)) {
+    context.report(metaProperty, 'Rule is missing a meta.docs.description property.')
+    return
+  }
+
+  if (!hasMetaDocsCategory(metaProperty)) {
+    context.report(metaProperty, 'Rule is missing a meta.docs.category property.')
+    return
+  }
+
+  if (!hasMetaDocsRecommended(metaProperty)) {
+    context.report(metaProperty, 'Rule is missing a meta.docs.recommended property.')
+    return
+  }
+
+  if (!hasMetaSchema(metaProperty)) {
+    context.report(metaProperty, 'Rule is missing a meta.schema property.')
+  }
+}
+
+/**
+ * Whether this node is the correct format for a rule definition or not.
+ *
+ * @param {ASTNode} node node that the rule exports.
+ * @returns {boolean} `true` if the exported node is the correct format for a rule definition
+ */
+function isCorrectExportsFormat (node) {
+  return node != null && node.type === 'ObjectExpression'
+}
+
+// ------------------------------------------------------------------------------
+// Rule Definition
+// ------------------------------------------------------------------------------
+
+module.exports = {
+  meta: {
+    docs: {
+      description: 'enforce correct use of `meta` property in core rules',
+      category: 'Internal',
+      recommended: false
+    },
+
+    schema: []
+  },
+
+  create (context) {
+    let exportsNode
+
+    return {
+      AssignmentExpression (node) {
+        if (node.left &&
+            node.right &&
+            node.left.type === 'MemberExpression' &&
+            node.left.object.name === 'module' &&
+            node.left.property.name === 'exports') {
+          exportsNode = node.right
+        }
+      },
+
+      'Program:exit' (programNode) {
+        if (!isCorrectExportsFormat(exportsNode)) {
+          context.report({ node: exportsNode || programNode, message: 'Rule does not export an Object. Make sure the rule follows the new rule format.' })
+          return
+        }
+
+        checkMetaValidity(context, exportsNode)
+      }
+    }
+  }
+}
diff --git a/lib/rules/.eslintrc.json b/lib/rules/.eslintrc.json
new file mode 100644
index 000000000..936029a17
--- /dev/null
+++ b/lib/rules/.eslintrc.json
@@ -0,0 +1,6 @@
+{
+  "rules": {
+    "consistent-docs-description": "error",
+    "no-invalid-meta": "error"
+  }
+}
diff --git a/lib/rules/attribute-hyphenation.js b/lib/rules/attribute-hyphenation.js
index fc0f81fd1..5637f8f87 100644
--- a/lib/rules/attribute-hyphenation.js
+++ b/lib/rules/attribute-hyphenation.js
@@ -58,7 +58,7 @@ function create (context) {
 module.exports = {
   meta: {
     docs: {
-      description: 'Define a style for the props casing in templates.',
+      description: 'enforce attribute naming style in template',
       category: 'Stylistic Issues',
       recommended: false
     },
diff --git a/lib/rules/html-end-tags.js b/lib/rules/html-end-tags.js
index 427896310..9a0f5bc22 100644
--- a/lib/rules/html-end-tags.js
+++ b/lib/rules/html-end-tags.js
@@ -58,7 +58,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'enforce end tag style.',
+      description: 'enforce end tag style',
       category: 'Best Practices',
       recommended: false
     },
diff --git a/lib/rules/html-no-self-closing.js b/lib/rules/html-no-self-closing.js
index a02d23a48..30673c82b 100644
--- a/lib/rules/html-no-self-closing.js
+++ b/lib/rules/html-no-self-closing.js
@@ -52,10 +52,10 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'disallow self-closing elements.',
+      description: 'disallow self-closing elements',
       category: 'Best Practices',
       recommended: false,
-      replacedBy: ['html-self-closing-style']
+      replacedBy: ['html-self-closing']
     },
     deprecated: true,
     fixable: 'code',
diff --git a/lib/rules/html-quotes.js b/lib/rules/html-quotes.js
index 26e8c3914..b6739f905 100644
--- a/lib/rules/html-quotes.js
+++ b/lib/rules/html-quotes.js
@@ -51,7 +51,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'enforce quotes style of HTML attributes.',
+      description: 'enforce quotes style of HTML attributes',
       category: 'Stylistic Issues',
       recommended: false
     },
diff --git a/lib/rules/html-self-closing.js b/lib/rules/html-self-closing.js
index 31e474098..5618df69d 100644
--- a/lib/rules/html-self-closing.js
+++ b/lib/rules/html-self-closing.js
@@ -142,7 +142,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'enforce self-closing style.',
+      description: 'enforce self-closing style',
       category: 'Stylistic Issues',
       recommended: false
     },
diff --git a/lib/rules/jsx-uses-vars.js b/lib/rules/jsx-uses-vars.js
index 70d8d491d..cc1fe70ee 100644
--- a/lib/rules/jsx-uses-vars.js
+++ b/lib/rules/jsx-uses-vars.js
@@ -37,7 +37,7 @@ SOFTWARE.
 module.exports = {
   meta: {
     docs: {
-      description: 'Prevent variables used in JSX to be marked as unused',
+      description: 'prevent variables used in JSX to be marked as unused', // eslint-disable-line consistent-docs-description
       category: 'Variables',
       recommended: true
     },
diff --git a/lib/rules/max-attributes-per-line.js b/lib/rules/max-attributes-per-line.js
index fd5c6c2bc..76f093415 100644
--- a/lib/rules/max-attributes-per-line.js
+++ b/lib/rules/max-attributes-per-line.js
@@ -12,7 +12,7 @@ const utils = require('../utils')
 module.exports = {
   meta: {
     docs: {
-      description: 'Define the number of attributes allows per line',
+      description: 'enforce the maximum number of attributes per line',
       category: 'Stylistic Issues',
       recommended: false
     },
diff --git a/lib/rules/mustache-interpolation-spacing.js b/lib/rules/mustache-interpolation-spacing.js
index d3086147e..0be368d80 100644
--- a/lib/rules/mustache-interpolation-spacing.js
+++ b/lib/rules/mustache-interpolation-spacing.js
@@ -17,7 +17,7 @@ const utils = require('../utils')
 module.exports = {
   meta: {
     docs: {
-      description: 'enforce unified spacing in mustache interpolations.',
+      description: 'enforce unified spacing in mustache interpolations',
       category: 'Stylistic Issues',
       recommended: false
     },
diff --git a/lib/rules/name-property-casing.js b/lib/rules/name-property-casing.js
index 89744d4bc..2bf2ca6a6 100644
--- a/lib/rules/name-property-casing.js
+++ b/lib/rules/name-property-casing.js
@@ -47,7 +47,7 @@ function create (context) {
 module.exports = {
   meta: {
     docs: {
-      description: 'Requires specific casing for the name property in Vue components',
+      description: 'enforce specific casing for the name property in Vue components',
       category: 'Stylistic Issues',
       recommended: false
     },
diff --git a/lib/rules/no-async-in-computed-properties.js b/lib/rules/no-async-in-computed-properties.js
index b42fa71c3..e1aef33ef 100644
--- a/lib/rules/no-async-in-computed-properties.js
+++ b/lib/rules/no-async-in-computed-properties.js
@@ -147,7 +147,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'Check if there are no asynchronous actions inside computed properties.',
+      description: 'disallow asynchronous actions in computed properties',
       category: 'Best Practices',
       recommended: false
     },
diff --git a/lib/rules/no-confusing-v-for-v-if.js b/lib/rules/no-confusing-v-for-v-if.js
index 8aa64ffff..26a8d8688 100644
--- a/lib/rules/no-confusing-v-for-v-if.js
+++ b/lib/rules/no-confusing-v-for-v-if.js
@@ -60,7 +60,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'disallow confusing `v-for` and `v-if` on the same element.',
+      description: 'disallow confusing `v-for` and `v-if` on the same element',
       category: 'Best Practices',
       recommended: true
     },
diff --git a/lib/rules/no-dupe-keys.js b/lib/rules/no-dupe-keys.js
index e9bcdcbab..4ae9766d1 100644
--- a/lib/rules/no-dupe-keys.js
+++ b/lib/rules/no-dupe-keys.js
@@ -46,7 +46,7 @@ function create (context) {
 module.exports = {
   meta: {
     docs: {
-      description: 'Prevents duplication of field names.',
+      description: 'disallow duplication of field names',
       category: 'Possible Errors',
       recommended: false
     },
diff --git a/lib/rules/no-duplicate-attributes.js b/lib/rules/no-duplicate-attributes.js
index b7bf7f84c..92fce05d6 100644
--- a/lib/rules/no-duplicate-attributes.js
+++ b/lib/rules/no-duplicate-attributes.js
@@ -88,7 +88,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'disallow duplicate attributes.',
+      description: 'disallow duplication of attributes',
       category: 'Best Practices',
       recommended: false
     },
diff --git a/lib/rules/no-invalid-template-root.js b/lib/rules/no-invalid-template-root.js
index 887ebd2ca..1dda8b808 100644
--- a/lib/rules/no-invalid-template-root.js
+++ b/lib/rules/no-invalid-template-root.js
@@ -112,7 +112,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'disallow invalid template root.',
+      description: 'disallow invalid template root',
       category: 'Possible Errors',
       recommended: false,
       replacedBy: ['valid-template-root']
diff --git a/lib/rules/no-invalid-v-bind.js b/lib/rules/no-invalid-v-bind.js
index 61ff9c22d..05aa8e0ff 100644
--- a/lib/rules/no-invalid-v-bind.js
+++ b/lib/rules/no-invalid-v-bind.js
@@ -56,7 +56,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'disallow invalid `v-bind` directives.',
+      description: 'disallow invalid `v-bind` directives',
       category: 'Possible Errors',
       recommended: false,
       replacedBy: ['valid-v-bind']
diff --git a/lib/rules/no-invalid-v-cloak.js b/lib/rules/no-invalid-v-cloak.js
index 39277a971..73ecabf21 100644
--- a/lib/rules/no-invalid-v-cloak.js
+++ b/lib/rules/no-invalid-v-cloak.js
@@ -57,7 +57,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'disallow invalid `v-cloak` directives.',
+      description: 'disallow invalid `v-cloak` directives',
       category: 'Possible Errors',
       recommended: false,
       replacedBy: ['valid-v-cloak']
diff --git a/lib/rules/no-invalid-v-else-if.js b/lib/rules/no-invalid-v-else-if.js
index 99e951365..69cd0ffa9 100644
--- a/lib/rules/no-invalid-v-else-if.js
+++ b/lib/rules/no-invalid-v-else-if.js
@@ -80,7 +80,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'disallow invalid `v-else-if` directives.',
+      description: 'disallow invalid `v-else-if` directives',
       category: 'Possible Errors',
       recommended: false,
       replacedBy: ['valid-v-else-if']
diff --git a/lib/rules/no-invalid-v-else.js b/lib/rules/no-invalid-v-else.js
index 0ee5dd49b..f06e9e12d 100644
--- a/lib/rules/no-invalid-v-else.js
+++ b/lib/rules/no-invalid-v-else.js
@@ -80,7 +80,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'disallow invalid `v-else` directives.',
+      description: 'disallow invalid `v-else` directives',
       category: 'Possible Errors',
       recommended: false,
       replacedBy: ['valid-v-else']
diff --git a/lib/rules/no-invalid-v-for.js b/lib/rules/no-invalid-v-for.js
index 2c16c40cd..66cd7e691 100644
--- a/lib/rules/no-invalid-v-for.js
+++ b/lib/rules/no-invalid-v-for.js
@@ -161,7 +161,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'disallow invalid `v-for` directives.',
+      description: 'disallow invalid `v-for` directives',
       category: 'Possible Errors',
       recommended: false,
       replacedBy: ['valid-v-for']
diff --git a/lib/rules/no-invalid-v-html.js b/lib/rules/no-invalid-v-html.js
index 3f71a3fdf..2bd6ef3a5 100644
--- a/lib/rules/no-invalid-v-html.js
+++ b/lib/rules/no-invalid-v-html.js
@@ -57,7 +57,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'disallow invalid `v-html` directives.',
+      description: 'disallow invalid `v-html` directives',
       category: 'Possible Errors',
       recommended: false,
       replacedBy: ['valid-v-html']
diff --git a/lib/rules/no-invalid-v-if.js b/lib/rules/no-invalid-v-if.js
index 27a280f2c..e24b2b6dc 100644
--- a/lib/rules/no-invalid-v-if.js
+++ b/lib/rules/no-invalid-v-if.js
@@ -73,7 +73,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'disallow invalid `v-if` directives.',
+      description: 'disallow invalid `v-if` directives',
       category: 'Possible Errors',
       recommended: false,
       replacedBy: ['valid-v-if']
diff --git a/lib/rules/no-invalid-v-model.js b/lib/rules/no-invalid-v-model.js
index 564df2389..8c243afc2 100644
--- a/lib/rules/no-invalid-v-model.js
+++ b/lib/rules/no-invalid-v-model.js
@@ -174,7 +174,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'disallow invalid `v-model` directives.',
+      description: 'disallow invalid `v-model` directives',
       category: 'Possible Errors',
       recommended: false,
       replacedBy: ['valid-v-model']
diff --git a/lib/rules/no-invalid-v-on.js b/lib/rules/no-invalid-v-on.js
index f3d1acccd..6a7577bed 100644
--- a/lib/rules/no-invalid-v-on.js
+++ b/lib/rules/no-invalid-v-on.js
@@ -62,7 +62,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'disallow invalid `v-on` directives.',
+      description: 'disallow invalid `v-on` directives',
       category: 'Possible Errors',
       recommended: false,
       replacedBy: ['valid-v-on']
diff --git a/lib/rules/no-invalid-v-once.js b/lib/rules/no-invalid-v-once.js
index 419fdbfbd..aa6c75d55 100644
--- a/lib/rules/no-invalid-v-once.js
+++ b/lib/rules/no-invalid-v-once.js
@@ -57,7 +57,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'disallow invalid `v-once` directives.',
+      description: 'disallow invalid `v-once` directives',
       category: 'Possible Errors',
       recommended: false,
       replacedBy: ['valid-v-once']
diff --git a/lib/rules/no-invalid-v-pre.js b/lib/rules/no-invalid-v-pre.js
index b6a025a12..3770107f9 100644
--- a/lib/rules/no-invalid-v-pre.js
+++ b/lib/rules/no-invalid-v-pre.js
@@ -57,7 +57,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'disallow invalid `v-pre` directives.',
+      description: 'disallow invalid `v-pre` directives',
       category: 'Possible Errors',
       recommended: false,
       replacedBy: ['valid-v-pre']
diff --git a/lib/rules/no-invalid-v-show.js b/lib/rules/no-invalid-v-show.js
index 424d04aa8..e98e271f1 100644
--- a/lib/rules/no-invalid-v-show.js
+++ b/lib/rules/no-invalid-v-show.js
@@ -57,7 +57,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'disallow invalid `v-show` directives.',
+      description: 'disallow invalid `v-show` directives',
       category: 'Possible Errors',
       recommended: false,
       replacedBy: ['valid-v-show']
diff --git a/lib/rules/no-invalid-v-text.js b/lib/rules/no-invalid-v-text.js
index f21f4cc24..e7716f24e 100644
--- a/lib/rules/no-invalid-v-text.js
+++ b/lib/rules/no-invalid-v-text.js
@@ -57,7 +57,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'disallow invalid `v-text` directives.',
+      description: 'disallow invalid `v-text` directives',
       category: 'Possible Errors',
       recommended: false,
       replacedBy: ['valid-v-text']
diff --git a/lib/rules/no-multi-spaces.js b/lib/rules/no-multi-spaces.js
index 2ba0baa4d..844cdbc62 100644
--- a/lib/rules/no-multi-spaces.js
+++ b/lib/rules/no-multi-spaces.js
@@ -11,7 +11,7 @@
 module.exports = {
   meta: {
     docs: {
-      description: 'This rule warns about the usage of extra whitespaces between attributes',
+      description: 'disallow multiple spaces',
       category: 'Stylistic Issues',
       recommended: false
     },
diff --git a/lib/rules/no-parsing-error.js b/lib/rules/no-parsing-error.js
index 94a3b1af1..8d48b547e 100644
--- a/lib/rules/no-parsing-error.js
+++ b/lib/rules/no-parsing-error.js
@@ -94,7 +94,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'disallow parsing errors in `<template>`.',
+      description: 'disallow parsing errors in `<template>`',
       category: 'Possible Errors',
       recommended: true
     },
diff --git a/lib/rules/no-reserved-keys.js b/lib/rules/no-reserved-keys.js
index bc4a89004..2489e4fec 100644
--- a/lib/rules/no-reserved-keys.js
+++ b/lib/rules/no-reserved-keys.js
@@ -49,7 +49,7 @@ function create (context) {
 module.exports = {
   meta: {
     docs: {
-      description: 'Prevent overwrite reserved keys.',
+      description: 'disallow overwriting reserved keys',
       category: 'Possible Errors',
       recommended: false
     },
diff --git a/lib/rules/no-reservered-keys.js b/lib/rules/no-reservered-keys.js
index e31fe710d..5528b424c 100644
--- a/lib/rules/no-reservered-keys.js
+++ b/lib/rules/no-reservered-keys.js
@@ -49,7 +49,7 @@ function create (context) {
 module.exports = {
   meta: {
     docs: {
-      description: 'Prevent overwrite reserved keys.',
+      description: 'disallow overwriting reserved keys',
       category: 'Possible Errors',
       recommended: false,
       replacedBy: ['no-reserved-keys']
diff --git a/lib/rules/no-shared-component-data.js b/lib/rules/no-shared-component-data.js
index 94d0c4c92..cf942ef13 100644
--- a/lib/rules/no-shared-component-data.js
+++ b/lib/rules/no-shared-component-data.js
@@ -37,7 +37,7 @@ function create (context) {
 module.exports = {
   meta: {
     docs: {
-      description: "Enforces component's data property to be a function.",
+      description: "enforce component's data property to be a function",
       category: 'Possible Errors',
       recommended: false
     },
diff --git a/lib/rules/no-side-effects-in-computed-properties.js b/lib/rules/no-side-effects-in-computed-properties.js
index ddc376f17..9ac247d17 100644
--- a/lib/rules/no-side-effects-in-computed-properties.js
+++ b/lib/rules/no-side-effects-in-computed-properties.js
@@ -62,7 +62,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'Don\'t introduce side effects in computed properties',
+      description: 'disallow side effects in computed properties',
       category: 'Best Practices',
       recommended: false
     },
diff --git a/lib/rules/no-template-key.js b/lib/rules/no-template-key.js
index 0659b9cf8..41e4b8fd0 100644
--- a/lib/rules/no-template-key.js
+++ b/lib/rules/no-template-key.js
@@ -43,7 +43,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'disallow `key` attribute on `<template>`.',
+      description: 'disallow `key` attribute on `<template>`',
       category: 'Possible Errors',
       recommended: false
     },
diff --git a/lib/rules/no-textarea-mustache.js b/lib/rules/no-textarea-mustache.js
index b1b9a67a8..9e4d0cbb2 100644
--- a/lib/rules/no-textarea-mustache.js
+++ b/lib/rules/no-textarea-mustache.js
@@ -45,7 +45,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'disallow mustaches in `<textarea>`.',
+      description: 'disallow mustaches in `<textarea>`',
       category: 'Best Practices',
       recommended: true
     },
diff --git a/lib/rules/order-in-components.js b/lib/rules/order-in-components.js
index e6a131f7c..3ea350501 100644
--- a/lib/rules/order-in-components.js
+++ b/lib/rules/order-in-components.js
@@ -95,7 +95,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'Keep order of properties in components',
+      description: 'enforce order of properties in components',
       category: 'Best Practices',
       recommended: false
     },
diff --git a/lib/rules/require-component-is.js b/lib/rules/require-component-is.js
index e60c778c2..e51727e35 100644
--- a/lib/rules/require-component-is.js
+++ b/lib/rules/require-component-is.js
@@ -43,7 +43,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'require `v-bind:is` of `<component>` elements.',
+      description: 'require `v-bind:is` of `<component>` elements',
       category: 'Best Practices',
       recommended: true
     },
diff --git a/lib/rules/require-default-prop.js b/lib/rules/require-default-prop.js
index b3010d4c9..1dbd266e6 100644
--- a/lib/rules/require-default-prop.js
+++ b/lib/rules/require-default-prop.js
@@ -13,7 +13,7 @@ const utils = require('../utils')
 module.exports = {
   meta: {
     docs: {
-      description: 'Require default value for props',
+      description: 'require default value for props',
       category: 'Best Practices',
       recommended: false
     },
diff --git a/lib/rules/require-prop-types.js b/lib/rules/require-prop-types.js
index d8291cf82..514bec509 100644
--- a/lib/rules/require-prop-types.js
+++ b/lib/rules/require-prop-types.js
@@ -80,7 +80,7 @@ function create (context) {
 module.exports = {
   meta: {
     docs: {
-      description: 'Prop definitions should be detailed',
+      description: 'require type definitions in props',
       category: 'Best Practices',
       recommended: false
     },
diff --git a/lib/rules/require-render-return.js b/lib/rules/require-render-return.js
index f7030d8f2..9ff268a93 100644
--- a/lib/rules/require-render-return.js
+++ b/lib/rules/require-render-return.js
@@ -43,7 +43,7 @@ function create (context) {
 module.exports = {
   meta: {
     docs: {
-      description: 'Enforces render function to always return value.',
+      description: 'enforce render function to always return value',
       category: 'Possible Errors',
       recommended: false
     },
diff --git a/lib/rules/require-v-for-key.js b/lib/rules/require-v-for-key.js
index cf53b80f8..448cd5351 100644
--- a/lib/rules/require-v-for-key.js
+++ b/lib/rules/require-v-for-key.js
@@ -58,7 +58,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'require `v-bind:key` with `v-for` directives.',
+      description: 'require `v-bind:key` with `v-for` directives',
       category: 'Best Practices',
       recommended: true
     },
diff --git a/lib/rules/require-valid-default-prop.js b/lib/rules/require-valid-default-prop.js
index 659df0183..d4c8ddca7 100644
--- a/lib/rules/require-valid-default-prop.js
+++ b/lib/rules/require-valid-default-prop.js
@@ -22,7 +22,7 @@ const NATIVE_TYPES = new Set([
 module.exports = {
   meta: {
     docs: {
-      description: 'Enforces props default values to be valid.',
+      description: 'enforce props default values to be valid',
       category: 'Possible Errors',
       recommended: false
     },
diff --git a/lib/rules/return-in-computed-property.js b/lib/rules/return-in-computed-property.js
index 627e61d03..a3a7858d3 100644
--- a/lib/rules/return-in-computed-property.js
+++ b/lib/rules/return-in-computed-property.js
@@ -47,7 +47,7 @@ function create (context) {
 module.exports = {
   meta: {
     docs: {
-      description: 'Enforces that a return statement is present in computed property.',
+      description: 'enforce that a return statement is present in computed property',
       category: 'Possible Errors',
       recommended: false
     },
diff --git a/lib/rules/this-in-template.js b/lib/rules/this-in-template.js
index 5ff3dca78..9095988a6 100644
--- a/lib/rules/this-in-template.js
+++ b/lib/rules/this-in-template.js
@@ -18,7 +18,7 @@ const RESERVED_NAMES = new Set(require('../utils/js-reserved.json'))
 module.exports = {
   meta: {
     docs: {
-      description: 'enforce usage of `this` in template.',
+      description: 'enforce usage of `this` in template',
       category: 'Best Practices',
       recommended: false
     },
diff --git a/lib/rules/v-bind-style.js b/lib/rules/v-bind-style.js
index c1a8e02fa..701be354f 100644
--- a/lib/rules/v-bind-style.js
+++ b/lib/rules/v-bind-style.js
@@ -52,7 +52,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'enforce `v-bind` directive style.',
+      description: 'enforce `v-bind` directive style',
       category: 'Stylistic Issues',
       recommended: false
     },
diff --git a/lib/rules/v-on-style.js b/lib/rules/v-on-style.js
index ef82482f3..e7b1b71a8 100644
--- a/lib/rules/v-on-style.js
+++ b/lib/rules/v-on-style.js
@@ -53,7 +53,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'enforce `v-on` directive style.',
+      description: 'enforce `v-on` directive style',
       category: 'Stylistic Issues',
       recommended: false
     },
diff --git a/lib/rules/valid-template-root.js b/lib/rules/valid-template-root.js
index 2f511d31e..989c69633 100644
--- a/lib/rules/valid-template-root.js
+++ b/lib/rules/valid-template-root.js
@@ -112,7 +112,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'enforce valid template root.',
+      description: 'enforce valid template root',
       category: 'Possible Errors',
       recommended: true
     },
diff --git a/lib/rules/valid-v-bind.js b/lib/rules/valid-v-bind.js
index 3238ed7e5..8d37a455b 100644
--- a/lib/rules/valid-v-bind.js
+++ b/lib/rules/valid-v-bind.js
@@ -56,7 +56,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'enforce valid `v-bind` directives.',
+      description: 'enforce valid `v-bind` directives',
       category: 'Possible Errors',
       recommended: true
     },
diff --git a/lib/rules/valid-v-cloak.js b/lib/rules/valid-v-cloak.js
index f2f646870..4aa2e891d 100644
--- a/lib/rules/valid-v-cloak.js
+++ b/lib/rules/valid-v-cloak.js
@@ -57,7 +57,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'enforce valid `v-cloak` directives.',
+      description: 'enforce valid `v-cloak` directives',
       category: 'Possible Errors',
       recommended: true
     },
diff --git a/lib/rules/valid-v-else-if.js b/lib/rules/valid-v-else-if.js
index b07dad7e4..6aee2a89e 100644
--- a/lib/rules/valid-v-else-if.js
+++ b/lib/rules/valid-v-else-if.js
@@ -80,7 +80,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'enforce valid `v-else-if` directives.',
+      description: 'enforce valid `v-else-if` directives',
       category: 'Possible Errors',
       recommended: true
     },
diff --git a/lib/rules/valid-v-else.js b/lib/rules/valid-v-else.js
index 8464e2c67..0733cd0a6 100644
--- a/lib/rules/valid-v-else.js
+++ b/lib/rules/valid-v-else.js
@@ -80,7 +80,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'enforce valid `v-else` directives.',
+      description: 'enforce valid `v-else` directives',
       category: 'Possible Errors',
       recommended: true
     },
diff --git a/lib/rules/valid-v-for.js b/lib/rules/valid-v-for.js
index 971bbb052..a3c303cba 100644
--- a/lib/rules/valid-v-for.js
+++ b/lib/rules/valid-v-for.js
@@ -188,7 +188,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'enforce valid `v-for` directives.',
+      description: 'enforce valid `v-for` directives',
       category: 'Possible Errors',
       recommended: true
     },
diff --git a/lib/rules/valid-v-html.js b/lib/rules/valid-v-html.js
index d3bf8b058..88a65f704 100644
--- a/lib/rules/valid-v-html.js
+++ b/lib/rules/valid-v-html.js
@@ -57,7 +57,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'enforce valid `v-html` directives.',
+      description: 'enforce valid `v-html` directives',
       category: 'Possible Errors',
       recommended: true
     },
diff --git a/lib/rules/valid-v-if.js b/lib/rules/valid-v-if.js
index 9f21e09c7..4c3880fae 100644
--- a/lib/rules/valid-v-if.js
+++ b/lib/rules/valid-v-if.js
@@ -73,7 +73,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'enforce valid `v-if` directives.',
+      description: 'enforce valid `v-if` directives',
       category: 'Possible Errors',
       recommended: true
     },
diff --git a/lib/rules/valid-v-model.js b/lib/rules/valid-v-model.js
index fd6e46cf9..7ec83489e 100644
--- a/lib/rules/valid-v-model.js
+++ b/lib/rules/valid-v-model.js
@@ -174,7 +174,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'enforce valid `v-model` directives.',
+      description: 'enforce valid `v-model` directives',
       category: 'Possible Errors',
       recommended: true
     },
diff --git a/lib/rules/valid-v-on.js b/lib/rules/valid-v-on.js
index 4dcc791c3..156e3669a 100644
--- a/lib/rules/valid-v-on.js
+++ b/lib/rules/valid-v-on.js
@@ -62,7 +62,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'enforce valid `v-on` directives.',
+      description: 'enforce valid `v-on` directives',
       category: 'Possible Errors',
       recommended: true
     },
diff --git a/lib/rules/valid-v-once.js b/lib/rules/valid-v-once.js
index e3391f4b8..522778c55 100644
--- a/lib/rules/valid-v-once.js
+++ b/lib/rules/valid-v-once.js
@@ -57,7 +57,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'enforce valid `v-once` directives.',
+      description: 'enforce valid `v-once` directives',
       category: 'Possible Errors',
       recommended: true
     },
diff --git a/lib/rules/valid-v-pre.js b/lib/rules/valid-v-pre.js
index a3855c661..b15778257 100644
--- a/lib/rules/valid-v-pre.js
+++ b/lib/rules/valid-v-pre.js
@@ -57,7 +57,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'enforce valid `v-pre` directives.',
+      description: 'enforce valid `v-pre` directives',
       category: 'Possible Errors',
       recommended: true
     },
diff --git a/lib/rules/valid-v-show.js b/lib/rules/valid-v-show.js
index 104894458..e8ecce1c2 100644
--- a/lib/rules/valid-v-show.js
+++ b/lib/rules/valid-v-show.js
@@ -57,7 +57,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'enforce valid `v-show` directives.',
+      description: 'enforce valid `v-show` directives',
       category: 'Possible Errors',
       recommended: true
     },
diff --git a/lib/rules/valid-v-text.js b/lib/rules/valid-v-text.js
index f3adb2508..d319b7019 100644
--- a/lib/rules/valid-v-text.js
+++ b/lib/rules/valid-v-text.js
@@ -57,7 +57,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'enforce valid `v-text` directives.',
+      description: 'enforce valid `v-text` directives',
       category: 'Possible Errors',
       recommended: true
     },
diff --git a/package.json b/package.json
index c99851609..ba543ad3c 100644
--- a/package.json
+++ b/package.json
@@ -7,7 +7,7 @@
     "start": "npm run test:base -- --watch --growl",
     "test:base": "mocha \"tests/lib/**/*.js\" --reporter dot",
     "test": "nyc npm run test:base -- \"tests/integrations/*.js\" --timeout 60000",
-    "lint": "eslint .",
+    "lint": "eslint . --rulesdir eslint-internal-rules",
     "pretest": "npm run lint",
     "preversion": "npm run update && npm test",
     "update": "node ./tools/update-rules.js"
diff --git a/tools/update-rules.js b/tools/update-rules.js
index 2f7992765..c1f50884e 100644
--- a/tools/update-rules.js
+++ b/tools/update-rules.js
@@ -110,3 +110,32 @@ fs.writeFileSync(
   recommendedRulesFile,
   recommendedRulesContent
 )
+
+/*
+ * The pattern to match document header.
+ * The header is one title line and zero or more unordered list items.
+ * E.g.
+ *
+ * # description
+ * - a note. (there are 3 kinds of notes: recommended, deprecated, and autofixable)
+ * - another note.
+ *
+ */
+const headerPattern = /^#[^\n]*\n+(?:- .+\n)*\n*/
+
+// Update the header of rule documents.
+const docsRoot = path.resolve(__dirname, '../docs/rules')
+for (const rule of rules) {
+  const ruleId = rule[0]
+  const meta = rule[1].meta
+  const filePath = path.join(docsRoot, `${ruleId}.md`)
+  const recommended = meta.docs.recommended ? `- ${STAR} The \`"extends": "plugin:vue/recommended"\` property in a configuration file enables this rule.\n` : ''
+  const deprecated = meta.deprecated ? `- ${WARN} This rule was **deprecated** and replaced by ${meta.docs.replacedBy.map(id => `[${id}](${id}.md) rule`).join(', ')}.\n` : ''
+  const autofix = meta.fixable ? `- ${PEN} The \`--fix\` option on the [command line](http://eslint.org/docs/user-guide/command-line-interface#fix) can automatically fix some of the problems reported by this rule.\n` : ''
+  const header = `# ${meta.docs.description} (${ruleId})\n${recommended || deprecated || autofix ? '\n' : ''}${recommended}${deprecated}${autofix}\n`
+
+  fs.writeFileSync(
+    filePath,
+    fs.readFileSync(filePath, 'utf8').replace(headerPattern, header)
+  )
+}