Docs: update docs

Author: mysticatea

README.md

@@ -71,6 +71,20 @@ Vue.component('AsyncComponent', (resolve, reject) => {
 })
 ```
 
+### `eslint-disable` functionality in `<template>`
+
+You can use `<!-- eslint-disable -->`-like HTML comments in `<template>` of `.vue` files. For example:
+
+```html
+<template>
+  <!-- eslint-disable-next-line vue/max-attributes-per-line -->
+  <div a="1" b="2" c="3" d="4">
+  </div>
+</template>
+```
+
+If you want to disallow `eslint-disable` functionality, please disable [vue/comment-directive](./docs/rules/comment-directive.md) rule.
+
 ## :gear: Configs
 
 This plugin provides two predefined configs:

docs/rules/comment-directive.md

@@ -1,6 +1,7 @@
 # support comment-directives in `<template>` (comment-directive)
 
-This rule supports the following comment directives in `<template>`:
+Sole purpose of this rule is to provide `eslint-disable` functionality in `<template>`.
+It supports usage of the following comments:
 
 - `eslint-disable`
 - `eslint-enable`
@@ -17,8 +18,16 @@ For example:
 </template>
 ```
 
+> Note: we can't write HTML comments in tags.
+
 This rule doesn't make any warning.
 
-## Further reading
+## :book: Rule Details
+
+ESLint doesn't provide any API to enhance `eslint-disable` functionality and ESLint rules cannot affect other rules. But ESLint provides [processors API](https://eslint.org/docs/developer-guide/working-with-plugins#processors-in-plugins).
+
+This rule sends all `eslint-disable`-like comments as warnings to the post-process of the `.vue` file processor, then the post-process removes all `vue/comment-directive` warnings and warnings in disabled-area.
+
+## :books: Further reading
 
 - [Disabling rules with inline comments](https://eslint.org/docs/user-guide/configuring#disabling-rules-with-inline-comments)