update html-self-closing

Author: mysticatea

docs/rules/html-self-closing.md

@@ -8,12 +8,32 @@ In Vue.js template, we can use either two styles for elements which don't have t
 1. `<YourComponent></YourComponent>`
 2. `<YourComponent/>` (self-closing)
 
-Self-closing is simple and shorter, but it's not supported in raw HTML.
-This rule helps you to unify the self-closing style.
+Self-closing is simple and shorter, but it's not supported in the HTML spec.
+This rule helps you to make consistent on the self-closing style.
 
-## Rule Details
+## :book: Rule Details
 
-This rule has options which specify self-closing style for each context.
+This rule aims to enforce the self-closing sign as the configured style.
+
+<eslint-code-block :rules="{'vue/html-self-closing': ['error']}">
+```
+<template>
+  <!-- ✓ GOOD -->
+  <div/>
+  <img>
+  <MyComponent/>
+  <svg><path d=""/></svg>
+
+  <!-- ✗ BAD -->
+  <div></div>
+  <img/>
+  <MyComponent></MyComponent>
+  <svg><path d=""></path></svg>
+</template>
+```
+</eslint-code-block>
+
+## :wrench: Options
 
 ```json
 {
@@ -41,28 +61,27 @@ Every option can be set to one of the following values:
 - `"never"` ... Disallow self-closing.
 - `"any"` ... Don't enforce self-closing style.
 
-----
+### `{html: {normal: "never", void: "always"}}`
 
-:-1: Examples of **incorrect** code for this rule:
-
-```html
-<div></div>
-<img/>
-<img></img>
-<MyComponent/></MyComponent>
-<svg><path d=""></path></svg>
+<eslint-code-block :rules="{'vue/html-self-closing': ['error', {html: {normal: 'never', void: 'always'}}]}">
 ```
-
-:+1: Examples of **correct** code for this rule:
-
-```html
-<div/>
-<img>
-<MyComponent/>
-<svg><path d=""/></svg>
+<template>
+  <!-- ✓ GOOD -->
+  <div></div>
+  <img/>
+  <MyComponent/>
+  <svg><path d=""/></svg>
+
+  <!-- ✗ BAD -->
+  <div/>
+  <img>
+  <MyComponent></MyComponent>
+  <svg><path d=""></path></svg>
+</template>
 ```
+</eslint-code-block>
 
-## Related links
+## :books: Further reading
 
 - [Style guide - Self closing components](https://vuejs.org/v2/style-guide/#Self-closing-components-strongly-recommended)