From cef7119e7f58c7c5913c44ef36ff025f4ef60511 Mon Sep 17 00:00:00 2001
From: Toru Nagashima <star.ctor@gmail.com>
Date: Wed, 9 Aug 2017 17:24:04 +0900
Subject: [PATCH 1/5] Docs: improve document's header

---
 docs/rules/attribute-hyphenation.md            |  4 +++-
 docs/rules/html-end-tags.md                    |  4 ++--
 docs/rules/html-no-self-closing.md             |  5 +++--
 docs/rules/html-quotes.md                      |  2 +-
 docs/rules/html-self-closing.md                |  4 +++-
 docs/rules/jsx-uses-vars.md                    |  2 ++
 docs/rules/name-property-casing.md             |  2 ++
 docs/rules/no-async-in-computed-properties.md  |  2 +-
 docs/rules/no-confusing-v-for-v-if.md          |  4 +++-
 docs/rules/no-dupe-keys.md                     |  2 +-
 docs/rules/no-duplicate-attributes.md          |  2 +-
 docs/rules/no-invalid-template-root.md         |  4 +++-
 docs/rules/no-invalid-v-bind.md                |  4 +++-
 docs/rules/no-invalid-v-cloak.md               |  4 +++-
 docs/rules/no-invalid-v-else-if.md             |  4 +++-
 docs/rules/no-invalid-v-else.md                |  4 +++-
 docs/rules/no-invalid-v-for.md                 |  4 +++-
 docs/rules/no-invalid-v-html.md                |  4 +++-
 docs/rules/no-invalid-v-if.md                  |  4 +++-
 docs/rules/no-invalid-v-model.md               |  4 +++-
 docs/rules/no-invalid-v-on.md                  |  4 +++-
 docs/rules/no-invalid-v-once.md                |  4 +++-
 docs/rules/no-invalid-v-pre.md                 |  4 +++-
 docs/rules/no-invalid-v-show.md                |  4 +++-
 docs/rules/no-invalid-v-text.md                |  4 +++-
 docs/rules/no-parsing-error.md                 |  4 +++-
 docs/rules/no-reservered-keys.md               |  2 +-
 docs/rules/no-shared-component-data.md         |  2 +-
 .../no-side-effects-in-computed-properties.md  |  2 +-
 docs/rules/no-template-key.md                  |  2 +-
 docs/rules/no-textarea-mustache.md             |  4 +++-
 docs/rules/order-in-components.md              |  2 +-
 docs/rules/require-component-is.md             |  4 +++-
 docs/rules/require-render-return.md            |  2 +-
 docs/rules/require-v-for-key.md                |  4 +++-
 docs/rules/require-valid-default-prop.md       |  2 +-
 docs/rules/return-in-computed-property.md      |  2 +-
 docs/rules/v-bind-style.md                     |  4 ++--
 docs/rules/v-on-style.md                       |  4 ++--
 docs/rules/valid-template-root.md              |  4 +++-
 docs/rules/valid-v-bind.md                     |  4 +++-
 docs/rules/valid-v-cloak.md                    |  4 +++-
 docs/rules/valid-v-else-if.md                  |  4 +++-
 docs/rules/valid-v-else.md                     |  4 +++-
 docs/rules/valid-v-for.md                      |  4 +++-
 docs/rules/valid-v-html.md                     |  4 +++-
 docs/rules/valid-v-if.md                       |  4 +++-
 docs/rules/valid-v-model.md                    |  4 +++-
 docs/rules/valid-v-on.md                       |  4 +++-
 docs/rules/valid-v-once.md                     |  4 +++-
 docs/rules/valid-v-pre.md                      |  4 +++-
 docs/rules/valid-v-show.md                     |  4 +++-
 docs/rules/valid-v-text.md                     |  4 +++-
 tools/update-rules.js                          | 18 ++++++++++++++++++
 54 files changed, 148 insertions(+), 55 deletions(-)

diff --git a/docs/rules/attribute-hyphenation.md b/docs/rules/attribute-hyphenation.md
index 7d83c9fad..b572e876e 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)
+# Define a style for the props casing in templates. (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..e71daaa30 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..a77f9fd42 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-style](html-self-closing-style.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..bed344deb 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..b910ed925 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..3dcd4a290 100644
--- a/docs/rules/jsx-uses-vars.md
+++ b/docs/rules/jsx-uses-vars.md
@@ -1,5 +1,7 @@
 # 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/name-property-casing.md b/docs/rules/name-property-casing.md
index 316cda8f3..6f3a93e26 100644
--- a/docs/rules/name-property-casing.md
+++ b/docs/rules/name-property-casing.md
@@ -1,5 +1,7 @@
 # Requires 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.
 
 ## :book: Rule Details
diff --git a/docs/rules/no-async-in-computed-properties.md b/docs/rules/no-async-in-computed-properties.md
index 83c48b59e..738c3d566 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)
+# Check if there are no asynchronous actions inside 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..24355741b 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..9188d7815 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)
+# Prevents 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..247da158e 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 duplicate 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..3bbb03e66 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..f99bbd503 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..4f4f9b267 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..c8aec1193 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..c277e9bbf 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..26e3e4494 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..a9b8c05c1 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..a55c32fee 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..610c731ee 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..d05fdf9b8 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..8635a0df8 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..74e7ea9b3 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..f82329c99 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..45446fb8b 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-parsing-error.md b/docs/rules/no-parsing-error.md
index ccdb44b3f..d5b44bef2 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-reservered-keys.md b/docs/rules/no-reservered-keys.md
index 4ec1aaa1f..1dc0b6187 100644
--- a/docs/rules/no-reservered-keys.md
+++ b/docs/rules/no-reservered-keys.md
@@ -1,4 +1,4 @@
-# Prevent overwrite reserved keys (no-reservered-keys)
+# Prevent overwrite reserved keys. (no-reservered-keys)
 
 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..7c742ee33 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)
+# Enforces 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..b8d6a4b65 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)
+# Don't introduce 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..adc9d8a5f 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..cfd53f7fd 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..d919f4597 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)
+# Keep 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..a55d98262 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-render-return.md b/docs/rules/require-render-return.md
index 5a2479f93..302d35b6b 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)
+# Enforces render function to always return value. (require-render-return)
 
 This rule aims to enforce render function to allways return value
 
diff --git a/docs/rules/require-v-for-key.md b/docs/rules/require-v-for-key.md
index 24672e12c..c7c2c2b41 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..935e2dfc7 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)
+# Enforces 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..3979245b2 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)
+# Enforces that a return statement is present in computed property. (return-in-computed-property)
 
 ## :book: Rule Details
 
diff --git a/docs/rules/v-bind-style.md b/docs/rules/v-bind-style.md
index 920023355..7f7e15126 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..19cb639bf 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..d2ba10db4 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..71f704ffc 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..f2a20a4e4 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..8b5fbfc93 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..5f882c29c 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..2ecb2c537 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..092a74bee 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..7fd1f8e55 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..7edc9583b 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..302e612f8 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..105e80d7f 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..053132727 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..ad6a81b80 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..604cc3e84 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/tools/update-rules.js b/tools/update-rules.js
index 65410bf08..165cf1083 100644
--- a/tools/update-rules.js
+++ b/tools/update-rules.js
@@ -110,3 +110,21 @@ fs.writeFileSync(
   recommendedRulesFile,
   recommendedRulesContent
 )
+
+// Update the header of rule documents.
+const headerPattern = /^#[^\n]*\n+(?:- .+\n)*\n*/
+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)
+  )
+}

From f696f6d1c842d2ee99773eeaf576b0e13c6a1e4a Mon Sep 17 00:00:00 2001
From: Toru Nagashima <star.ctor@gmail.com>
Date: Sun, 13 Aug 2017 18:14:03 +0900
Subject: [PATCH 2/5] Add some internal rules for description

---
 .vscode/settings.json                         |   5 +-
 README.md                                     |  78 ++++----
 docs/rules/attribute-hyphenation.md           |   2 +-
 docs/rules/html-end-tags.md                   |   2 +-
 docs/rules/html-no-self-closing.md            |   2 +-
 docs/rules/html-quotes.md                     |   2 +-
 docs/rules/html-self-closing.md               |   2 +-
 docs/rules/jsx-uses-vars.md                   |   2 +-
 docs/rules/name-property-casing.md            |   2 +-
 docs/rules/no-async-in-computed-properties.md |   2 +-
 docs/rules/no-confusing-v-for-v-if.md         |   2 +-
 docs/rules/no-dupe-keys.md                    |   2 +-
 docs/rules/no-duplicate-attributes.md         |   2 +-
 docs/rules/no-invalid-template-root.md        |   2 +-
 docs/rules/no-invalid-v-bind.md               |   2 +-
 docs/rules/no-invalid-v-cloak.md              |   2 +-
 docs/rules/no-invalid-v-else-if.md            |   2 +-
 docs/rules/no-invalid-v-else.md               |   2 +-
 docs/rules/no-invalid-v-for.md                |   2 +-
 docs/rules/no-invalid-v-html.md               |   2 +-
 docs/rules/no-invalid-v-if.md                 |   2 +-
 docs/rules/no-invalid-v-model.md              |   2 +-
 docs/rules/no-invalid-v-on.md                 |   2 +-
 docs/rules/no-invalid-v-once.md               |   2 +-
 docs/rules/no-invalid-v-pre.md                |   2 +-
 docs/rules/no-invalid-v-show.md               |   2 +-
 docs/rules/no-invalid-v-text.md               |   2 +-
 docs/rules/no-parsing-error.md                |   2 +-
 docs/rules/no-reservered-keys.md              |   2 +-
 docs/rules/no-shared-component-data.md        |   2 +-
 .../no-side-effects-in-computed-properties.md |   2 +-
 docs/rules/no-template-key.md                 |   2 +-
 docs/rules/no-textarea-mustache.md            |   2 +-
 docs/rules/order-in-components.md             |   2 +-
 docs/rules/require-component-is.md            |   2 +-
 docs/rules/require-prop-types.md              |   2 +-
 docs/rules/require-render-return.md           |   2 +-
 docs/rules/require-v-for-key.md               |   2 +-
 docs/rules/require-valid-default-prop.md      |   2 +-
 docs/rules/return-in-computed-property.md     |   2 +-
 docs/rules/v-bind-style.md                    |   2 +-
 docs/rules/v-on-style.md                      |   2 +-
 docs/rules/valid-template-root.md             |   2 +-
 docs/rules/valid-v-bind.md                    |   2 +-
 docs/rules/valid-v-cloak.md                   |   2 +-
 docs/rules/valid-v-else-if.md                 |   2 +-
 docs/rules/valid-v-else.md                    |   2 +-
 docs/rules/valid-v-for.md                     |   2 +-
 docs/rules/valid-v-html.md                    |   2 +-
 docs/rules/valid-v-if.md                      |   2 +-
 docs/rules/valid-v-model.md                   |   2 +-
 docs/rules/valid-v-on.md                      |   2 +-
 docs/rules/valid-v-once.md                    |   2 +-
 docs/rules/valid-v-pre.md                     |   2 +-
 docs/rules/valid-v-show.md                    |   2 +-
 docs/rules/valid-v-text.md                    |   2 +-
 eslint-internal-rules/.eslintrc.json          |   6 +
 .../consistent-docs-description.js            | 138 +++++++++++++
 eslint-internal-rules/no-invalid-meta.js      | 187 ++++++++++++++++++
 lib/rules/.eslintrc.json                      |   6 +
 lib/rules/attribute-hyphenation.js            |   2 +-
 lib/rules/html-end-tags.js                    |   2 +-
 lib/rules/html-no-self-closing.js             |   2 +-
 lib/rules/html-quotes.js                      |   2 +-
 lib/rules/html-self-closing.js                |   2 +-
 lib/rules/jsx-uses-vars.js                    |   2 +-
 lib/rules/name-property-casing.js             |   2 +-
 lib/rules/no-async-in-computed-properties.js  |   2 +-
 lib/rules/no-confusing-v-for-v-if.js          |   2 +-
 lib/rules/no-dupe-keys.js                     |   2 +-
 lib/rules/no-duplicate-attributes.js          |   2 +-
 lib/rules/no-invalid-template-root.js         |   2 +-
 lib/rules/no-invalid-v-bind.js                |   2 +-
 lib/rules/no-invalid-v-cloak.js               |   2 +-
 lib/rules/no-invalid-v-else-if.js             |   2 +-
 lib/rules/no-invalid-v-else.js                |   2 +-
 lib/rules/no-invalid-v-for.js                 |   2 +-
 lib/rules/no-invalid-v-html.js                |   2 +-
 lib/rules/no-invalid-v-if.js                  |   2 +-
 lib/rules/no-invalid-v-model.js               |   2 +-
 lib/rules/no-invalid-v-on.js                  |   2 +-
 lib/rules/no-invalid-v-once.js                |   2 +-
 lib/rules/no-invalid-v-pre.js                 |   2 +-
 lib/rules/no-invalid-v-show.js                |   2 +-
 lib/rules/no-invalid-v-text.js                |   2 +-
 lib/rules/no-parsing-error.js                 |   2 +-
 lib/rules/no-reservered-keys.js               |   2 +-
 lib/rules/no-shared-component-data.js         |   2 +-
 .../no-side-effects-in-computed-properties.js |   2 +-
 lib/rules/no-template-key.js                  |   2 +-
 lib/rules/no-textarea-mustache.js             |   2 +-
 lib/rules/order-in-components.js              |   2 +-
 lib/rules/require-component-is.js             |   2 +-
 lib/rules/require-prop-types.js               |   2 +-
 lib/rules/require-render-return.js            |   2 +-
 lib/rules/require-v-for-key.js                |   2 +-
 lib/rules/require-valid-default-prop.js       |   2 +-
 lib/rules/return-in-computed-property.js      |   2 +-
 lib/rules/v-bind-style.js                     |   2 +-
 lib/rules/v-on-style.js                       |   2 +-
 lib/rules/valid-template-root.js              |   2 +-
 lib/rules/valid-v-bind.js                     |   2 +-
 lib/rules/valid-v-cloak.js                    |   2 +-
 lib/rules/valid-v-else-if.js                  |   2 +-
 lib/rules/valid-v-else.js                     |   2 +-
 lib/rules/valid-v-for.js                      |   2 +-
 lib/rules/valid-v-html.js                     |   2 +-
 lib/rules/valid-v-if.js                       |   2 +-
 lib/rules/valid-v-model.js                    |   2 +-
 lib/rules/valid-v-on.js                       |   2 +-
 lib/rules/valid-v-once.js                     |   2 +-
 lib/rules/valid-v-pre.js                      |   2 +-
 lib/rules/valid-v-show.js                     |   2 +-
 lib/rules/valid-v-text.js                     |   2 +-
 package.json                                  |   2 +-
 115 files changed, 489 insertions(+), 149 deletions(-)
 create mode 100644 eslint-internal-rules/.eslintrc.json
 create mode 100644 eslint-internal-rules/consistent-docs-description.js
 create mode 100644 eslint-internal-rules/no-invalid-meta.js
 create mode 100644 lib/rules/.eslintrc.json

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 a6d61292a..1d4caf733 100644
--- a/README.md
+++ b/README.md
@@ -92,63 +92,63 @@ 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-reservered-keys](./docs/rules/no-reservered-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-reservered-keys](./docs/rules/no-reservered-keys.md) | disallow overwrite 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-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. |
+| :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 duplicate 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-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 |
 
 
 ### 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. |
-| :wrench: | [name-property-casing](./docs/rules/name-property-casing.md) | Requires specific casing for the name property in Vue components |
-| :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 |
+| :wrench: | [name-property-casing](./docs/rules/name-property-casing.md) | enforce specific casing for the name property in Vue components |
+| :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
 
diff --git a/docs/rules/attribute-hyphenation.md b/docs/rules/attribute-hyphenation.md
index b572e876e..0028c2a58 100644
--- a/docs/rules/attribute-hyphenation.md
+++ b/docs/rules/attribute-hyphenation.md
@@ -1,4 +1,4 @@
-# Define a style for the props casing in templates. (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.
 
diff --git a/docs/rules/html-end-tags.md b/docs/rules/html-end-tags.md
index e71daaa30..059fc3fed 100644
--- a/docs/rules/html-end-tags.md
+++ b/docs/rules/html-end-tags.md
@@ -1,4 +1,4 @@
-# enforce end tag style. (html-end-tags)
+# enforce end tag style (html-end-tags)
 
 - :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/html-no-self-closing.md b/docs/rules/html-no-self-closing.md
index a77f9fd42..d559073be 100644
--- a/docs/rules/html-no-self-closing.md
+++ b/docs/rules/html-no-self-closing.md
@@ -1,4 +1,4 @@
-# disallow self-closing elements. (html-no-self-closing)
+# disallow self-closing elements (html-no-self-closing)
 
 - :warning: This rule was **deprecated** and replaced by [html-self-closing-style](html-self-closing-style.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.
diff --git a/docs/rules/html-quotes.md b/docs/rules/html-quotes.md
index bed344deb..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 b910ed925..2a89d6732 100644
--- a/docs/rules/html-self-closing.md
+++ b/docs/rules/html-self-closing.md
@@ -1,4 +1,4 @@
-# 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.
 
diff --git a/docs/rules/jsx-uses-vars.md b/docs/rules/jsx-uses-vars.md
index 3dcd4a290..a236eebc5 100644
--- a/docs/rules/jsx-uses-vars.md
+++ b/docs/rules/jsx-uses-vars.md
@@ -1,4 +1,4 @@
-# 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.
 
diff --git a/docs/rules/name-property-casing.md b/docs/rules/name-property-casing.md
index 6f3a93e26..648935b58 100644
--- a/docs/rules/name-property-casing.md
+++ b/docs/rules/name-property-casing.md
@@ -1,4 +1,4 @@
-# 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.
 
diff --git a/docs/rules/no-async-in-computed-properties.md b/docs/rules/no-async-in-computed-properties.md
index 738c3d566..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 24355741b..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,4 @@
-# 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.
 
diff --git a/docs/rules/no-dupe-keys.md b/docs/rules/no-dupe-keys.md
index 9188d7815..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 247da158e..6259e15d0 100644
--- a/docs/rules/no-duplicate-attributes.md
+++ b/docs/rules/no-duplicate-attributes.md
@@ -1,4 +1,4 @@
-# disallow duplicate attributes. (no-duplicate-attributes)
+# disallow duplicate 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 3bbb03e66..d154097ea 100644
--- a/docs/rules/no-invalid-template-root.md
+++ b/docs/rules/no-invalid-template-root.md
@@ -1,4 +1,4 @@
-# disallow invalid template root. (no-invalid-template-root)
+# disallow invalid template root (no-invalid-template-root)
 
 - :warning: This rule was **deprecated** and replaced by [valid-template-root](valid-template-root.md) rule.
 
diff --git a/docs/rules/no-invalid-v-bind.md b/docs/rules/no-invalid-v-bind.md
index f99bbd503..c820e14fe 100644
--- a/docs/rules/no-invalid-v-bind.md
+++ b/docs/rules/no-invalid-v-bind.md
@@ -1,4 +1,4 @@
-# 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.
 
diff --git a/docs/rules/no-invalid-v-cloak.md b/docs/rules/no-invalid-v-cloak.md
index 4f4f9b267..931b8eeec 100644
--- a/docs/rules/no-invalid-v-cloak.md
+++ b/docs/rules/no-invalid-v-cloak.md
@@ -1,4 +1,4 @@
-# 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.
 
diff --git a/docs/rules/no-invalid-v-else-if.md b/docs/rules/no-invalid-v-else-if.md
index c8aec1193..e724f7fec 100644
--- a/docs/rules/no-invalid-v-else-if.md
+++ b/docs/rules/no-invalid-v-else-if.md
@@ -1,4 +1,4 @@
-# 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.
 
diff --git a/docs/rules/no-invalid-v-else.md b/docs/rules/no-invalid-v-else.md
index c277e9bbf..82c2cc17d 100644
--- a/docs/rules/no-invalid-v-else.md
+++ b/docs/rules/no-invalid-v-else.md
@@ -1,4 +1,4 @@
-# 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.
 
diff --git a/docs/rules/no-invalid-v-for.md b/docs/rules/no-invalid-v-for.md
index 26e3e4494..4953d3b3e 100644
--- a/docs/rules/no-invalid-v-for.md
+++ b/docs/rules/no-invalid-v-for.md
@@ -1,4 +1,4 @@
-# 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.
 
diff --git a/docs/rules/no-invalid-v-html.md b/docs/rules/no-invalid-v-html.md
index a9b8c05c1..370ad818f 100644
--- a/docs/rules/no-invalid-v-html.md
+++ b/docs/rules/no-invalid-v-html.md
@@ -1,4 +1,4 @@
-# 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.
 
diff --git a/docs/rules/no-invalid-v-if.md b/docs/rules/no-invalid-v-if.md
index a55c32fee..99cabc5a2 100644
--- a/docs/rules/no-invalid-v-if.md
+++ b/docs/rules/no-invalid-v-if.md
@@ -1,4 +1,4 @@
-# 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.
 
diff --git a/docs/rules/no-invalid-v-model.md b/docs/rules/no-invalid-v-model.md
index 610c731ee..281cdfaf9 100644
--- a/docs/rules/no-invalid-v-model.md
+++ b/docs/rules/no-invalid-v-model.md
@@ -1,4 +1,4 @@
-# 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.
 
diff --git a/docs/rules/no-invalid-v-on.md b/docs/rules/no-invalid-v-on.md
index d05fdf9b8..85aff4d0e 100644
--- a/docs/rules/no-invalid-v-on.md
+++ b/docs/rules/no-invalid-v-on.md
@@ -1,4 +1,4 @@
-# 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.
 
diff --git a/docs/rules/no-invalid-v-once.md b/docs/rules/no-invalid-v-once.md
index 8635a0df8..605da17a7 100644
--- a/docs/rules/no-invalid-v-once.md
+++ b/docs/rules/no-invalid-v-once.md
@@ -1,4 +1,4 @@
-# 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.
 
diff --git a/docs/rules/no-invalid-v-pre.md b/docs/rules/no-invalid-v-pre.md
index 74e7ea9b3..514df58f2 100644
--- a/docs/rules/no-invalid-v-pre.md
+++ b/docs/rules/no-invalid-v-pre.md
@@ -1,4 +1,4 @@
-# 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.
 
diff --git a/docs/rules/no-invalid-v-show.md b/docs/rules/no-invalid-v-show.md
index f82329c99..a6513f04e 100644
--- a/docs/rules/no-invalid-v-show.md
+++ b/docs/rules/no-invalid-v-show.md
@@ -1,4 +1,4 @@
-# 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.
 
diff --git a/docs/rules/no-invalid-v-text.md b/docs/rules/no-invalid-v-text.md
index 45446fb8b..627a8ecdf 100644
--- a/docs/rules/no-invalid-v-text.md
+++ b/docs/rules/no-invalid-v-text.md
@@ -1,4 +1,4 @@
-# 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.
 
diff --git a/docs/rules/no-parsing-error.md b/docs/rules/no-parsing-error.md
index d5b44bef2..6770b5da1 100644
--- a/docs/rules/no-parsing-error.md
+++ b/docs/rules/no-parsing-error.md
@@ -1,4 +1,4 @@
-# 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.
 
diff --git a/docs/rules/no-reservered-keys.md b/docs/rules/no-reservered-keys.md
index 1dc0b6187..242b06964 100644
--- a/docs/rules/no-reservered-keys.md
+++ b/docs/rules/no-reservered-keys.md
@@ -1,4 +1,4 @@
-# Prevent overwrite reserved keys. (no-reservered-keys)
+# disallow overwrite reserved keys (no-reservered-keys)
 
 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 7c742ee33..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 b8d6a4b65..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 @@
-# Don't 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 adc9d8a5f..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 cfd53f7fd..14a2ee54c 100644
--- a/docs/rules/no-textarea-mustache.md
+++ b/docs/rules/no-textarea-mustache.md
@@ -1,4 +1,4 @@
-# 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.
 
diff --git a/docs/rules/order-in-components.md b/docs/rules/order-in-components.md
index d919f4597..d246eb1b0 100644
--- a/docs/rules/order-in-components.md
+++ b/docs/rules/order-in-components.md
@@ -1,4 +1,4 @@
-# Keep order of properties in 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 a55d98262..41fe9b23d 100644
--- a/docs/rules/require-component-is.md
+++ b/docs/rules/require-component-is.md
@@ -1,4 +1,4 @@
-# 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.
 
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 302d35b6b..70ccd29d8 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 allways return value
 
diff --git a/docs/rules/require-v-for-key.md b/docs/rules/require-v-for-key.md
index c7c2c2b41..9db96c330 100644
--- a/docs/rules/require-v-for-key.md
+++ b/docs/rules/require-v-for-key.md
@@ -1,4 +1,4 @@
-# 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.
 
diff --git a/docs/rules/require-valid-default-prop.md b/docs/rules/require-valid-default-prop.md
index 935e2dfc7..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 3979245b2..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/v-bind-style.md b/docs/rules/v-bind-style.md
index 7f7e15126..1375306bc 100644
--- a/docs/rules/v-bind-style.md
+++ b/docs/rules/v-bind-style.md
@@ -1,4 +1,4 @@
-# enforce `v-bind` directive style. (v-bind-style)
+# enforce `v-bind` directive style (v-bind-style)
 
 - :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/v-on-style.md b/docs/rules/v-on-style.md
index 19cb639bf..144ee12b7 100644
--- a/docs/rules/v-on-style.md
+++ b/docs/rules/v-on-style.md
@@ -1,4 +1,4 @@
-# enforce `v-on` directive style. (v-on-style)
+# enforce `v-on` directive style (v-on-style)
 
 - :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/valid-template-root.md b/docs/rules/valid-template-root.md
index d2ba10db4..bde86b40a 100644
--- a/docs/rules/valid-template-root.md
+++ b/docs/rules/valid-template-root.md
@@ -1,4 +1,4 @@
-# enforce valid template root. (valid-template-root)
+# enforce valid template root (valid-template-root)
 
 - :white_check_mark: The `"extends": "plugin:vue/recommended"` property in a configuration file enables this rule.
 
diff --git a/docs/rules/valid-v-bind.md b/docs/rules/valid-v-bind.md
index 71f704ffc..bcb01ed2e 100644
--- a/docs/rules/valid-v-bind.md
+++ b/docs/rules/valid-v-bind.md
@@ -1,4 +1,4 @@
-# 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.
 
diff --git a/docs/rules/valid-v-cloak.md b/docs/rules/valid-v-cloak.md
index f2a20a4e4..b0905c3d4 100644
--- a/docs/rules/valid-v-cloak.md
+++ b/docs/rules/valid-v-cloak.md
@@ -1,4 +1,4 @@
-# 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.
 
diff --git a/docs/rules/valid-v-else-if.md b/docs/rules/valid-v-else-if.md
index 8b5fbfc93..83916b7bd 100644
--- a/docs/rules/valid-v-else-if.md
+++ b/docs/rules/valid-v-else-if.md
@@ -1,4 +1,4 @@
-# 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.
 
diff --git a/docs/rules/valid-v-else.md b/docs/rules/valid-v-else.md
index 5f882c29c..f9e849a98 100644
--- a/docs/rules/valid-v-else.md
+++ b/docs/rules/valid-v-else.md
@@ -1,4 +1,4 @@
-# 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.
 
diff --git a/docs/rules/valid-v-for.md b/docs/rules/valid-v-for.md
index 2ecb2c537..59d05bda5 100644
--- a/docs/rules/valid-v-for.md
+++ b/docs/rules/valid-v-for.md
@@ -1,4 +1,4 @@
-# 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.
 
diff --git a/docs/rules/valid-v-html.md b/docs/rules/valid-v-html.md
index 092a74bee..1967bbe7a 100644
--- a/docs/rules/valid-v-html.md
+++ b/docs/rules/valid-v-html.md
@@ -1,4 +1,4 @@
-# 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.
 
diff --git a/docs/rules/valid-v-if.md b/docs/rules/valid-v-if.md
index 7fd1f8e55..bee8ab638 100644
--- a/docs/rules/valid-v-if.md
+++ b/docs/rules/valid-v-if.md
@@ -1,4 +1,4 @@
-# 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.
 
diff --git a/docs/rules/valid-v-model.md b/docs/rules/valid-v-model.md
index 7edc9583b..1c71de3a8 100644
--- a/docs/rules/valid-v-model.md
+++ b/docs/rules/valid-v-model.md
@@ -1,4 +1,4 @@
-# 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.
 
diff --git a/docs/rules/valid-v-on.md b/docs/rules/valid-v-on.md
index 302e612f8..df9554444 100644
--- a/docs/rules/valid-v-on.md
+++ b/docs/rules/valid-v-on.md
@@ -1,4 +1,4 @@
-# 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.
 
diff --git a/docs/rules/valid-v-once.md b/docs/rules/valid-v-once.md
index 105e80d7f..40972e39f 100644
--- a/docs/rules/valid-v-once.md
+++ b/docs/rules/valid-v-once.md
@@ -1,4 +1,4 @@
-# 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.
 
diff --git a/docs/rules/valid-v-pre.md b/docs/rules/valid-v-pre.md
index 053132727..26692301e 100644
--- a/docs/rules/valid-v-pre.md
+++ b/docs/rules/valid-v-pre.md
@@ -1,4 +1,4 @@
-# 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.
 
diff --git a/docs/rules/valid-v-show.md b/docs/rules/valid-v-show.md
index ad6a81b80..4a7589044 100644
--- a/docs/rules/valid-v-show.md
+++ b/docs/rules/valid-v-show.md
@@ -1,4 +1,4 @@
-# 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.
 
diff --git a/docs/rules/valid-v-text.md b/docs/rules/valid-v-text.md
index 604cc3e84..b447705c7 100644
--- a/docs/rules/valid-v-text.md
+++ b/docs/rules/valid-v-text.md
@@ -1,4 +1,4 @@
-# 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.
 
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 177b7a10a..e610144c6 100644
--- a/lib/rules/attribute-hyphenation.js
+++ b/lib/rules/attribute-hyphenation.js
@@ -60,7 +60,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 511351095..190c57ab9 100644
--- a/lib/rules/html-end-tags.js
+++ b/lib/rules/html-end-tags.js
@@ -60,7 +60,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 b85ab12fd..7edcbc57d 100644
--- a/lib/rules/html-no-self-closing.js
+++ b/lib/rules/html-no-self-closing.js
@@ -54,7 +54,7 @@ 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']
diff --git a/lib/rules/html-quotes.js b/lib/rules/html-quotes.js
index 2dd4ec45c..82496080d 100644
--- a/lib/rules/html-quotes.js
+++ b/lib/rules/html-quotes.js
@@ -53,7 +53,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 7dc2bb28b..b25bf0bd8 100644
--- a/lib/rules/html-self-closing.js
+++ b/lib/rules/html-self-closing.js
@@ -144,7 +144,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..4a6df862e 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/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 d69632243..ae1abe55b 100644
--- a/lib/rules/no-confusing-v-for-v-if.js
+++ b/lib/rules/no-confusing-v-for-v-if.js
@@ -62,7 +62,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 53b918ed1..336eeee53 100644
--- a/lib/rules/no-duplicate-attributes.js
+++ b/lib/rules/no-duplicate-attributes.js
@@ -90,7 +90,7 @@ module.exports = {
   create,
   meta: {
     docs: {
-      description: 'disallow duplicate attributes.',
+      description: 'disallow duplicate 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 081452e92..bf5cd559d 100644
--- a/lib/rules/no-invalid-v-bind.js
+++ b/lib/rules/no-invalid-v-bind.js
@@ -58,7 +58,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 d292d9f78..c70efe694 100644
--- a/lib/rules/no-invalid-v-cloak.js
+++ b/lib/rules/no-invalid-v-cloak.js
@@ -59,7 +59,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 21ec073da..c2d2d8c53 100644
--- a/lib/rules/no-invalid-v-else-if.js
+++ b/lib/rules/no-invalid-v-else-if.js
@@ -82,7 +82,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 1455bed0e..ab61d6668 100644
--- a/lib/rules/no-invalid-v-else.js
+++ b/lib/rules/no-invalid-v-else.js
@@ -82,7 +82,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 1cb022f94..20df12549 100644
--- a/lib/rules/no-invalid-v-for.js
+++ b/lib/rules/no-invalid-v-for.js
@@ -163,7 +163,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 b0606b574..dc1e66fb3 100644
--- a/lib/rules/no-invalid-v-html.js
+++ b/lib/rules/no-invalid-v-html.js
@@ -59,7 +59,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 89a5a6ade..1d2a3581b 100644
--- a/lib/rules/no-invalid-v-if.js
+++ b/lib/rules/no-invalid-v-if.js
@@ -75,7 +75,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 cd75bf10f..e5170944a 100644
--- a/lib/rules/no-invalid-v-model.js
+++ b/lib/rules/no-invalid-v-model.js
@@ -176,7 +176,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 ef54544f3..a6e5bc77c 100644
--- a/lib/rules/no-invalid-v-on.js
+++ b/lib/rules/no-invalid-v-on.js
@@ -64,7 +64,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 f8c67b8b1..d298517ba 100644
--- a/lib/rules/no-invalid-v-once.js
+++ b/lib/rules/no-invalid-v-once.js
@@ -59,7 +59,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 76e640250..e7b0e951f 100644
--- a/lib/rules/no-invalid-v-pre.js
+++ b/lib/rules/no-invalid-v-pre.js
@@ -59,7 +59,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 e7ea46d04..60ca63d42 100644
--- a/lib/rules/no-invalid-v-show.js
+++ b/lib/rules/no-invalid-v-show.js
@@ -59,7 +59,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 7ebda73e0..c356d905f 100644
--- a/lib/rules/no-invalid-v-text.js
+++ b/lib/rules/no-invalid-v-text.js
@@ -59,7 +59,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-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-reservered-keys.js b/lib/rules/no-reservered-keys.js
index c0ba613f2..e239b3c90 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 overwrite reserved keys',
       category: 'Possible Errors',
       recommended: false
     },
diff --git a/lib/rules/no-shared-component-data.js b/lib/rules/no-shared-component-data.js
index 67e2ec45f..e8e96707a 100644
--- a/lib/rules/no-shared-component-data.js
+++ b/lib/rules/no-shared-component-data.js
@@ -36,7 +36,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 b9677e462..7708ae72b 100644
--- a/lib/rules/no-template-key.js
+++ b/lib/rules/no-template-key.js
@@ -45,7 +45,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 fd637a8f4..2ad5da3e2 100644
--- a/lib/rules/no-textarea-mustache.js
+++ b/lib/rules/no-textarea-mustache.js
@@ -47,7 +47,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 d35d6458a..2b647d1f7 100644
--- a/lib/rules/order-in-components.js
+++ b/lib/rules/order-in-components.js
@@ -93,7 +93,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 e72587feb..550803d28 100644
--- a/lib/rules/require-component-is.js
+++ b/lib/rules/require-component-is.js
@@ -45,7 +45,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-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 5125fc5d8..ed6d716a4 100644
--- a/lib/rules/require-v-for-key.js
+++ b/lib/rules/require-v-for-key.js
@@ -60,7 +60,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 22dbe5b4d..3a4e0e623 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/v-bind-style.js b/lib/rules/v-bind-style.js
index 1093171dd..3b74568a4 100644
--- a/lib/rules/v-bind-style.js
+++ b/lib/rules/v-bind-style.js
@@ -54,7 +54,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 fead015c7..8daefd33e 100644
--- a/lib/rules/v-on-style.js
+++ b/lib/rules/v-on-style.js
@@ -55,7 +55,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 699bedaaf..2cc438dda 100644
--- a/lib/rules/valid-v-bind.js
+++ b/lib/rules/valid-v-bind.js
@@ -58,7 +58,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 b567f3a44..b3acf09ee 100644
--- a/lib/rules/valid-v-cloak.js
+++ b/lib/rules/valid-v-cloak.js
@@ -59,7 +59,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 1889728a4..0778f4b47 100644
--- a/lib/rules/valid-v-else-if.js
+++ b/lib/rules/valid-v-else-if.js
@@ -82,7 +82,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 a5d80d53d..c05f68cc3 100644
--- a/lib/rules/valid-v-else.js
+++ b/lib/rules/valid-v-else.js
@@ -82,7 +82,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 47d8f5029..eb61413ab 100644
--- a/lib/rules/valid-v-for.js
+++ b/lib/rules/valid-v-for.js
@@ -163,7 +163,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 fdb5f6657..abf256218 100644
--- a/lib/rules/valid-v-html.js
+++ b/lib/rules/valid-v-html.js
@@ -59,7 +59,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 090026ff2..733f460e3 100644
--- a/lib/rules/valid-v-if.js
+++ b/lib/rules/valid-v-if.js
@@ -75,7 +75,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 406ac8734..dcda961e9 100644
--- a/lib/rules/valid-v-model.js
+++ b/lib/rules/valid-v-model.js
@@ -176,7 +176,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 d590ef95b..76fe42fd8 100644
--- a/lib/rules/valid-v-on.js
+++ b/lib/rules/valid-v-on.js
@@ -64,7 +64,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 eefc4a30b..1c4c85ca2 100644
--- a/lib/rules/valid-v-once.js
+++ b/lib/rules/valid-v-once.js
@@ -59,7 +59,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 e3e42d083..478b36dbe 100644
--- a/lib/rules/valid-v-pre.js
+++ b/lib/rules/valid-v-pre.js
@@ -59,7 +59,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 b724a9bd4..d26588fdf 100644
--- a/lib/rules/valid-v-show.js
+++ b/lib/rules/valid-v-show.js
@@ -59,7 +59,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 0fe20cbfd..d38767955 100644
--- a/lib/rules/valid-v-text.js
+++ b/lib/rules/valid-v-text.js
@@ -59,7 +59,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 643b95ff9..157aff4a4 100644
--- a/package.json
+++ b/package.json
@@ -8,7 +8,7 @@
     "test:base": "mocha \"tests/lib/**/*.js\"",
     "test:simple": "npm run test:base -- --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"

From 03691d0ab3d7d67856dc7a1dfe2cae7cb3fb8bc6 Mon Sep 17 00:00:00 2001
From: Toru Nagashima <star.ctor@gmail.com>
Date: Sun, 13 Aug 2017 18:20:47 +0900
Subject: [PATCH 3/5] fix typo

---
 README.md                          | 2 +-
 docs/rules/html-no-self-closing.md | 2 +-
 lib/rules/html-no-self-closing.js  | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 1d4caf733..f3129b736 100644
--- a/README.md
+++ b/README.md
@@ -157,7 +157,7 @@ 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) |
+| [html-no-self-closing](./rules/html-no-self-closing.md) | [html-self-closing](./rules/html-self-closing.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) |
diff --git a/docs/rules/html-no-self-closing.md b/docs/rules/html-no-self-closing.md
index d559073be..bda6e3328 100644
--- a/docs/rules/html-no-self-closing.md
+++ b/docs/rules/html-no-self-closing.md
@@ -1,6 +1,6 @@
 # disallow self-closing elements (html-no-self-closing)
 
-- :warning: This rule was **deprecated** and replaced by [html-self-closing-style](html-self-closing-style.md) rule.
+- :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.
diff --git a/lib/rules/html-no-self-closing.js b/lib/rules/html-no-self-closing.js
index 7edcbc57d..3b855c9e3 100644
--- a/lib/rules/html-no-self-closing.js
+++ b/lib/rules/html-no-self-closing.js
@@ -57,7 +57,7 @@ module.exports = {
       description: 'disallow self-closing elements',
       category: 'Best Practices',
       recommended: false,
-      replacedBy: ['html-self-closing-style']
+      replacedBy: ['html-self-closing']
     },
     deprecated: true,
     fixable: 'code',

From dd2d1f2d6af33c4e30797d72eba6879fff245e5d Mon Sep 17 00:00:00 2001
From: Toru Nagashima <star.ctor@gmail.com>
Date: Fri, 8 Sep 2017 20:33:44 +0900
Subject: [PATCH 4/5] update for suggestions

---
 lib/rules/no-duplicate-attributes.js |  2 +-
 lib/rules/no-reservered-keys.js      |  2 +-
 tools/update-rules.js                | 13 ++++++++++++-
 3 files changed, 14 insertions(+), 3 deletions(-)

diff --git a/lib/rules/no-duplicate-attributes.js b/lib/rules/no-duplicate-attributes.js
index 336eeee53..791903748 100644
--- a/lib/rules/no-duplicate-attributes.js
+++ b/lib/rules/no-duplicate-attributes.js
@@ -90,7 +90,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-reservered-keys.js b/lib/rules/no-reservered-keys.js
index e239b3c90..39ffb505d 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: 'disallow overwrite reserved keys',
+      description: 'disallow overwriting reserved keys',
       category: 'Possible Errors',
       recommended: false
     },
diff --git a/tools/update-rules.js b/tools/update-rules.js
index 165cf1083..43ab23096 100644
--- a/tools/update-rules.js
+++ b/tools/update-rules.js
@@ -111,8 +111,19 @@ fs.writeFileSync(
   recommendedRulesContent
 )
 
-// Update the header of rule documents.
+/*
+ * 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]

From bce3dd0bfa1f753d0494938c736d3145fd2ac88a Mon Sep 17 00:00:00 2001
From: Toru Nagashima <star.ctor@gmail.com>
Date: Fri, 8 Sep 2017 20:43:30 +0900
Subject: [PATCH 5/5] update for new rules

---
 README.md                                    | 14 +++++++-------
 docs/rules/max-attributes-per-line.md        |  2 +-
 docs/rules/mustache-interpolation-spacing.md |  2 +-
 docs/rules/no-multi-spaces.md                |  2 +-
 docs/rules/no-reserved-keys.md               |  2 +-
 docs/rules/require-default-prop.md           |  2 +-
 docs/rules/this-in-template.md               |  2 +-
 lib/rules/max-attributes-per-line.js         |  2 +-
 lib/rules/mustache-interpolation-spacing.js  |  2 +-
 lib/rules/no-multi-spaces.js                 |  2 +-
 lib/rules/no-reserved-keys.js                |  2 +-
 lib/rules/require-default-prop.js            |  2 +-
 lib/rules/this-in-template.js                |  2 +-
 13 files changed, 19 insertions(+), 19 deletions(-)

diff --git a/README.md b/README.md
index 2bc2ad5dd..303f0b341 100644
--- a/README.md
+++ b/README.md
@@ -94,7 +94,7 @@ The `--fix` option on the command line automatically fixes problems reported by
 |:---|:--------|:------------|
 |  | [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) | Prevent overwrite reserved keys. |
+|  | [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 |
@@ -128,10 +128,10 @@ The `--fix` option on the command line automatically fixes problems reported by
 | :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-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. |
+|  | [this-in-template](./docs/rules/this-in-template.md) | enforce usage of `this` in template |
 
 
 ### Stylistic Issues
@@ -141,10 +141,10 @@ The `--fix` option on the command line automatically fixes problems reported by
 | :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) | Define the number of attributes allows per line |
-| :wrench: | [mustache-interpolation-spacing](./docs/rules/mustache-interpolation-spacing.md) | enforce unified spacing in mustache interpolations. |
+|  | [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) | This rule warns about the usage of extra whitespaces between attributes |
+| :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 |
 
@@ -153,7 +153,7 @@ The `--fix` option on the command line automatically fixes problems reported by
 
 |    | 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
 
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/no-multi-spaces.md b/docs/rules/no-multi-spaces.md
index 5f5c0ecc7..c098248d5 100644
--- a/docs/rules/no-multi-spaces.md
+++ b/docs/rules/no-multi-spaces.md
@@ -1,4 +1,4 @@
-# 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.
 
diff --git a/docs/rules/no-reserved-keys.md b/docs/rules/no-reserved-keys.md
index 3809e3dcd..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/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/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/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/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-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/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/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
     },