docs: improve organization, formatting, and consistency for rule docs.

Author: bmish

docs/rule/attribute-indentation.md

@@ -2,7 +2,7 @@
 
 This rule requires the positional params, attributes and block params of the helper/component to be indented by moving them to multiple lines when the open invocation has more than 80 characters (configurable).
 
-#### Forbidden:
+### Forbidden
 
 Non-Block form
 ``` hbs
@@ -30,7 +30,7 @@ Block form (HTML)
   <a href="https://www.emberjs.com" class="emberjs-home link" rel="noopener" target="_blank">Ember JS</a>
 ```
 
-#### Allowed:
+### Allowed
 
 Non-Block form
 ``` hbs
@@ -117,10 +117,14 @@ Block form (HTML)
   </a>
 ```
 
-#### Configuration:
+### Configuration
   * boolean - `true` - Enables the rule to be enforced when the opening invocation has more than 80 characters or when it spans multiple lines.
   * object - { 'indentation': n spaces } - Indentation length for attributes (defaults to `2`).
   * object - { 'open-invocation-max-len': n characters } - Maximum length of the opening invocation.
   * object - { 'process-elements': `true` } - Also validate the indentation of HTML/SVG elements.
   * object - { 'element-open-end': `new-line`|`last-attribute` } - Enforce the position of the closing brace `>` to be on a new line or next to the last attribute (defaults to `new-line`).
   * object - { 'mustache-open-end': `new-line`|`last-attribute` } - Enforce the position of the closing braces `}}` to be on a new line or next to the last attribute (defaults to `new-line`).
+
+### Related Rules
+
+* [attribute-indentation](attribute-indentation.md)

docs/rule/block-indentation.md

@@ -2,7 +2,7 @@
 
 Good indentation is crucial for long term maintenance of templates. For example, having blocks misaligned is a common cause of logic errors...
 
-This rule forbids the following examples:
+This rule **forbids** the following:
 
 ``` hbs
   {{#each foo as |bar}}
@@ -19,8 +19,14 @@ This rule forbids the following examples:
   <p>{{t 'Stuff here!'}}</p></div>
 ```
 
+### Configuration
+
 The following values are valid configuration:
 
   * boolean -- `true` indicates a 2 space indent, `false` indicates that the rule is disabled.
   * numeric -- the number of spaces to require for indentation
   * "tab" -- To indicate tab style indentation (1 char)
+
+### Related Rules
+
+  * [block-indentation](block-indentation.md)

docs/rule/deprecations/deprecated-each-syntax.md

@@ -3,20 +3,22 @@
 In Ember 2.0, support for using the `in` form of the `{{#each}}` helper
 has been removed.
 
-For example, this rule forbids the following:
+This rule **forbids** the following:
 
 ```hbs
 {{#each post in posts}}
   <li>{{post.name}}</li>
 {{/each}}
 ```
 
-Instead, you should write the template as:
+This rule **allows** the following:
 
 ```hbs
 {{#each posts as |post|}}
   <li>{{post.name}}</li>
 {{/each}}
 ```
 
-More information is available at the [Deprecation Guide](http://emberjs.com/deprecations/v1.x/#toc_code-in-code-syntax-for-code-each-code).
+### References
+
+* More information is available at the [Deprecation Guide](http://emberjs.com/deprecations/v1.x/#toc_code-in-code-syntax-for-code-each-code).

docs/rule/deprecations/deprecated-inline-view-helper.md

@@ -2,7 +2,7 @@
 
 In Ember 1.12, support for invoking the inline View helper was deprecated.
 
-For example, this rule forbids the following:
+This rule **forbids** the following:
 
 ```hbs
 {{view 'this-is-bad'}}
@@ -16,7 +16,7 @@ For example, this rule forbids the following:
 <div foo={{view.bar}}></div>
 ```
 
-Instead, you should use:
+This rule **allows** the following:
 
 ```hbs
 {{this-is-better}}
@@ -28,4 +28,6 @@ Instead, you should use:
 <div foo={{bar}}></div>
 ```
 
-More information is available at the [Deprecation Guide](http://emberjs.com/deprecations/v1.x/#toc_ember-view).
+### References
+
+* More information is available at the [Deprecation Guide](http://emberjs.com/deprecations/v1.x/#toc_ember-view).

docs/rule/deprecations/deprecated-render-helper.md

@@ -2,20 +2,22 @@
 
 In Ember 2.6 and newer, support for using the `{{render}}` helper has been deprecated.
 
-For example, this rule forbids the following:
+This rule **forbids** the following:
 
 ```hbs
 {{render 'this-is-bad'}}
 
 {{render 'also-bad' model}}
 ```
 
-Instead, you should use:
+This rule **allows** the following:
 
 ```hbs
 {{this-is-better}}
 
 {{saul-goodman model=model}}
 ```
 
-More information is available at the [Deprecation Guide](https://emberjs.com/deprecations/v2.x/#toc_code-render-code-helper).
+### References
+
+* More information is available at the [Deprecation Guide](https://emberjs.com/deprecations/v2.x/#toc_code-render-code-helper).

docs/rule/eol-last.md

@@ -1,6 +1,6 @@
-#### eol-last
+## eol-last
 
-Require or disallow newline at the end of files. Similar to https://eslint.org/docs/rules/eol-last.
+Require or disallow newline at the end of files.
 
 Enforce either:
 
@@ -15,6 +15,12 @@ or:
 
 ```
 
+### Configuration
+
 The following values are valid configuration:
 
   * string -- "always" enforces that files end with a newline, "never" enforces that files do not end with a newline
+
+### Related Rules
+
+* [eol-last](https://eslint.org/docs/rules/eol-last) from eslint

docs/rule/img-alt-attributes.md

@@ -4,18 +4,14 @@ An `<img>` without an `alt` attribute is essentially invisible to assistive tech
 In order to ensure that screen readers can provide useful information, we need to ensure that all `<img>` elements
 have an `alt` specified. See [WCAG Suggestion H37](https://www.w3.org/TR/WCAG20-TECHS/H37.html).
 
-The rule forbids the following:
+This rule **forbids** the following:
 
 ```hbs
 <img src="rwjblue.png">
 ```
 
-Instead, you should write the template as:
+This rule **allows** the following:
 
 ```hbs
 <img src="rwjblue.png" alt="picture of Robert Jackson">
 ```
-
-The following values are valid configuration:
-
-  * boolean -- `true` for enabled / `false` for disabled

docs/rule/inline-link-to.md

@@ -2,13 +2,13 @@
 
 Ember's `link-to` component has both an inline form and a block form. This rule forbids the inline form.
 
-Forbidden (inline form):
+This rule **forbids** the following (inline form):
 
 ```hbs
 {{link-to 'Link text' 'routeName' prop1 prop2}}
 ```
 
-Allowed (block form):
+This rule **allows** the following (block form):
 
 ```hbs
 {{#link-to 'routeName' prop1 prop2}}Link text{{/link-to}}
@@ -19,7 +19,3 @@ The block form is a little longer but has advantages over the inline form:
 * It maps closer to the use of HTML anchor tags which wrap their inner content.
 * It provides an obvious way for developers to put nested markup and components inside of their link.
 * The block form's argument order is more direct: "link to route". The inline form's argument order is somewhat ambiguous (link text then link target). This is opposite of the order in HTML (`href` then link text).
-
-This rule is configured with one boolean value:
-
-  * boolean -- `true` for enabled / `false` for disabled

docs/rule/invocable-blacklist.md

@@ -2,13 +2,13 @@
 
 Disallow certain components or helpers from being used. Use case is you bring in some addon like ember-composable-helpers, but your team deems one or many of the helpers not suitable and wants to guard against their usage.
 
-Given a config of
+Given a config of:
 
 ```js
 'invocable-blacklist': ['foo']
 ```
 
-#### Forbidden:
+This rule **forbids** the following:
 
 ```hbs
 {{foo}}
@@ -18,5 +18,6 @@ Given a config of
 {{#foo}}{{/foo}}
 ```
 
-#### Configuration:
+### Configuration
+
   * array of strings - helpers or components to blacklist

docs/rule/linebreak-style.md

@@ -1,7 +1,9 @@
-#### linebreak-style
+## linebreak-style
 
 Having consistent linebreaks is important to make sure that the source code is rendered correctly in editors.
 
+### Configuration
+
 This rule is configured with a boolean, or a string value:
 
 * boolean -- `true` for enforcing consistency (all `CRLF` or all `LF` not both in a single file)

docs/rule/link-href-attributes.md

@@ -4,19 +4,15 @@ It's common to treat anchor tags as a button: `<a {{action 'handleClick'}}>Submi
 
 However, this is typically considered bad practice as an anchor tag without an `href` is unfocusable which break accessability.
 
-This rule forbids the following:
+This rule **forbids** the following:
 
 ```hbs
 <a>I'm a fake link</a>
 <a {{action 'handleClick'}}>I'm a fake link</a>
 ```
 
-Instead, you should write the template as:
+This rule **allows** the following:
 
 ```hbs
 <a href="https://alink.com">I'm a real link</a>
 ```
-
-The following values are valid configuration:
-
-  * boolean -- `true` for enabled / `false` for disabled

docs/rule/link-rel-noopener.md

@@ -8,18 +8,20 @@ to a malicious clone to perform phishing on your users.
 Adding `rel="noopener noreferrer"` closes that door and avoids javascript in the opened tab to block the main
 thread in the opener. Also note that Firefox versions prior 52 do not implement `noopener` and `rel="noreferrer"` should be used instead [ see Firefox issue ](https://bugzilla.mozilla.org/show_bug.cgi?id=1222516) and https://html.spec.whatwg.org/multipage/semantics.html#link-type-noreferrer.
 
-This rule forbids the following:
+This rule **forbids** the following:
 
 ```hbs
 <a href="https://i.seem.secure.com" target="_blank">I'm a bait</a>
 ```
 
-Instead, you should write the template as:
+This rule **allows** the following:
 
 ```hbs
 <a href="https://i.seem.secure.com" target="_blank" rel="noopener noreferrer">I'm a bait</a>
 ```
 
+### Configuration
+
 The following values are valid configuration:
 
   * string -- `strict` for enabled and validating both noopener `and` noreferrer

docs/rule/no-action-modifiers.md

@@ -1,18 +1,21 @@
 ## no-action-modifiers
 
-This rule forbids the use of `{{action}}` modifiers on elements. The following
-code will throw an error:
+This rule forbids the use of `{{action}}` modifiers on elements.
+
+This rule **forbids** the following:
 
 ```hbs
 <button {{action 'handleClick'}}>
 ```
 
-The following code will be accepted:
+This rule **allows** the following:
 
 ```hbs
 <button onclick={{action 'handleClick'}}>
 ```
 
+### Configuration
+
 The following values are valid configuration:
 
   * boolean -- `true` for enabled / `false` for disabled

docs/rule/no-attrs-in-components.md

@@ -2,24 +2,21 @@
 
 This rule prevents the usage of `attrs` property to access values passed to the component since all the values can be accessed directly from the template.
 
-For example, doing
+This rule **forbids** the following:
 
 ```components/templates/layout.hbs
 {{attr.foo}}
 ```
-is bad. The correct way would be to directly consume `foo` in the template like,
+This rule **allows** the following:
+
+The correct way would be to directly consume `foo` in the template like:
 
 ```components/templates/layout.hbs
 {{foo}}
 ```
 
-or if you using Ember 3.1 and above,
+or if you using Ember 3.1 and above:
 
 ```components/templates/layout.hbs
 {{@foo}}
 ```
-
-
-The following values are valid configuration:
-
-  * boolean -- `true` for enabled / `false` for disabled

docs/rule/no-bare-strings.md

@@ -2,12 +2,14 @@
 
 In order to be able to internationalize your application, you will need to avoid using plain strings in your templates. Instead, you would need to use a template helper specializing in translation ([ember-intl](https://github.com/ember-intl/ember-intl) is the recommended project to use this for).
 
-This rule forbids the following:
+This rule **forbids** the following:
 
 ``` html
 <h2>Some string here!</h2>
 ```
 
+### Configuration
+
  The following values are valid configuration:
 
    * boolean -- `true` for enabled / `false` for disabled
@@ -21,5 +23,3 @@ When the config value of `true` is used the following configuration is used:
  * `whitelist` - `(),.&+-=*/#%!?:[]{}`
  * `globalAttributes` - `title`, `aria-label`, `aria-placeholder`, `aria-roledescription`, `aria-valuetext`
  * `elementAttributes` - `{ img: ['alt'], input: ['placeholder'] }`
-
-

docs/rule/no-debugger.md

@@ -2,7 +2,7 @@
 
 `{{debugger}}` will inject `debugger` statement into compiled template code and will pause its rendering if developer tools are open. That is undesirable in a production environment.
 
-This rule forbids usage of the following:
+This rule **forbids** the following:
 
 ```hbs
 {{debugger}}

docs/rule/no-duplicate-attributes.md

@@ -2,20 +2,14 @@
 
 This rule forbids multiple attributes passed to a Component, Helper or an ElementNode with the same name.
 
-For Instance:
-
-Forbidden (multiple attributes with the same name):
+This rule **forbids** the following (multiple attributes with the same name):
 
 ```hbs
 {{employee-details name=name age=age name=name}}
 ```
 
-Allowed:
+This rule **allows** the following:
 
 ```hbs
 {{employee-details name=name age=age}}
 ```
-
-This rule is configured with one boolean value:
-
-  * boolean -- `true` for enabled / `false` for disabled