docs: fix examples for several rules (#17645)

mdjermanovic · web-flow · commit a58aa200fcce · 2023-10-13T10:46:08.000-04:00
diff --git a/docs/src/rules/arrow-body-style.md b/docs/src/rules/arrow-body-style.md
@@ -32,6 +32,7 @@ Examples of **incorrect** code for this rule with the `"always"` option:
 ```js
 /*eslint arrow-body-style: ["error", "always"]*/
 /*eslint-env es6*/
+
 let foo = () => 0;
 ```
 
@@ -42,6 +43,9 @@ Examples of **correct** code for this rule with the `"always"` option:
 :::correct
 
 ```js
+/*eslint arrow-body-style: ["error", "always"]*/
+/*eslint-env es6*/
+
 let foo = () => {
     return 0;
 };
diff --git a/docs/src/rules/function-paren-newline.md b/docs/src/rules/function-paren-newline.md
@@ -339,11 +339,15 @@ var barbaz = function(
   bar, baz
 ) {};
 
-var barbaz = (bar,
-  baz) => {};
+var barbaz = (
+  bar,
+  baz
+) => {};
 
-foo(bar,
-  baz);
+foo(
+  bar,
+  baz
+);
 ```
 
 :::
diff --git a/docs/src/rules/id-match.md b/docs/src/rules/id-match.md
@@ -143,7 +143,7 @@ Examples of **correct** code for this rule with the `"^[a-z]+([A-Z][a-z]+)*$", {
 ```js
 /*eslint id-match: [2, "^[a-z]+([A-Z][a-z]+)*$", { "onlyDeclarations": true }]*/
 
-do_something(__dirname);
+foo = __dirname;
 ```
 
 :::
diff --git a/docs/src/rules/indent.md b/docs/src/rules/indent.md
@@ -192,7 +192,7 @@ Examples of **correct** code for this rule with the `4, { "ignoredNodes": ["Call
 foo();
 bar();
 
-})
+})();
 ```
 
 :::
@@ -403,7 +403,7 @@ function foo(x) {
 })();
 
 if (y) {
-   console.log('foo');
+  console.log('foo');
 }
 ```
 
diff --git a/docs/src/rules/lines-around-directive.md b/docs/src/rules/lines-around-directive.md
@@ -65,14 +65,8 @@ Examples of **incorrect** code for this rule with the `"always"` option:
 ```js
 /* eslint lines-around-directive: ["error", "always"] */
 
-/* Top of file */
-"use strict";
-var foo;
-
-/* Top of file */
 // comment
 "use strict";
-"use asm";
 var foo;
 
 function foo() {
@@ -90,23 +84,29 @@ function foo() {
 
 :::
 
-Examples of **correct** code for this rule with the `"always"` option:
-
-::: correct { "sourceType": "script" }
+::: incorrect { "sourceType": "script" }
 
 ```js
 /* eslint lines-around-directive: ["error", "always"] */
 
-/* Top of file */
+// comment
 "use strict";
-
+"use asm";
 var foo;
+```
+
+:::
+
+Examples of **correct** code for this rule with the `"always"` option:
+
+::: correct { "sourceType": "script" }
+
+```js
+/* eslint lines-around-directive: ["error", "always"] */
 
-/* Top of file */
 // comment
 
 "use strict";
-"use asm";
 
 var foo;
 
@@ -128,6 +128,21 @@ function foo() {
 
 :::
 
+::: correct { "sourceType": "script" }
+
+```js
+/* eslint lines-around-directive: ["error", "always"] */
+
+// comment
+
+"use strict";
+"use asm";
+
+var foo;
+```
+
+:::
+
 ### never
 
 Examples of **incorrect** code for this rule with the `"never"` option:
@@ -137,17 +152,9 @@ Examples of **incorrect** code for this rule with the `"never"` option:
 ```js
 /* eslint lines-around-directive: ["error", "never"] */
 
-/* Top of file */
-
-"use strict";
-
-var foo;
-
-/* Top of file */
 // comment
 
 "use strict";
-"use asm";
 
 var foo;
 
@@ -169,21 +176,30 @@ function foo() {
 
 :::
 
-Examples of **correct** code for this rule with the `"never"` option:
-
-::: correct { "sourceType": "script" }
+::: incorrect { "sourceType": "script" }
 
 ```js
 /* eslint lines-around-directive: ["error", "never"] */
 
-/* Top of file */
+// comment
+
 "use strict";
+"use asm";
+
 var foo;
+```
+
+:::
+
+Examples of **correct** code for this rule with the `"never"` option:
+
+::: correct { "sourceType": "script" }
+
+```js
+/* eslint lines-around-directive: ["error", "never"] */
 
-/* Top of file */
 // comment
 "use strict";
-"use asm";
 var foo;
 
 function foo() {
@@ -201,6 +217,19 @@ function foo() {
 
 :::
 
+::: correct { "sourceType": "script" }
+
+```js
+/* eslint lines-around-directive: ["error", "never"] */
+
+// comment
+"use strict";
+"use asm";
+var foo;
+```
+
+:::
+
 ### before & after
 
 Examples of **incorrect** code for this rule with the `{ "before": "never", "after": "always" }` option:
@@ -210,16 +239,9 @@ Examples of **incorrect** code for this rule with the `{ "before": "never", "aft
 ```js
 /* eslint lines-around-directive: ["error", { "before": "never", "after": "always" }] */
 
-/* Top of file */
-
-"use strict";
-var foo;
-
-/* Top of file */
 // comment
 
 "use strict";
-"use asm";
 var foo;
 
 function foo() {
@@ -238,22 +260,29 @@ function foo() {
 
 :::
 
-Examples of **correct** code for this rule with the `{ "before": "never", "after": "always" }`  option:
-
-::: correct { "sourceType": "script" }
+::: incorrect { "sourceType": "script" }
 
 ```js
 /* eslint lines-around-directive: ["error", { "before": "never", "after": "always" }] */
 
-/* Top of file */
-"use strict";
+// comment
 
+"use strict";
+"use asm";
 var foo;
+```
+
+:::
+
+Examples of **correct** code for this rule with the `{ "before": "never", "after": "always" }`  option:
+
+::: correct { "sourceType": "script" }
+
+```js
+/* eslint lines-around-directive: ["error", { "before": "never", "after": "always" }] */
 
-/* Top of file */
 // comment
 "use strict";
-"use asm";
 
 var foo;
 
@@ -274,22 +303,29 @@ function foo() {
 
 :::
 
-Examples of **incorrect** code for this rule with the `{ "before": "always", "after": "never" }` option:
-
-::: incorrect { "sourceType": "script" }
+::: correct { "sourceType": "script" }
 
 ```js
-/* eslint lines-around-directive: ["error", { "before": "always", "after": "never" }] */
+/* eslint lines-around-directive: ["error", { "before": "never", "after": "always" }] */
 
-/* Top of file */
+// comment
 "use strict";
+"use asm";
 
 var foo;
+```
+
+:::
+
+Examples of **incorrect** code for this rule with the `{ "before": "always", "after": "never" }` option:
+
+::: incorrect { "sourceType": "script" }
+
+```js
+/* eslint lines-around-directive: ["error", { "before": "always", "after": "never" }] */
 
-/* Top of file */
 // comment
 "use strict";
-"use asm";
 
 var foo;
 
@@ -310,22 +346,30 @@ function foo() {
 
 :::
 
-Examples of **correct** code for this rule with the `{ "before": "always", "after": "never" }` option:
-
-::: correct { "sourceType": "script" }
+::: incorrect { "sourceType": "script" }
 
 ```js
 /* eslint lines-around-directive: ["error", { "before": "always", "after": "never" }] */
 
-/* Top of file */
+// comment
 "use strict";
+"use asm";
+
 var foo;
+```
+
+:::
+
+Examples of **correct** code for this rule with the `{ "before": "always", "after": "never" }` option:
+
+::: correct { "sourceType": "script" }
+
+```js
+/* eslint lines-around-directive: ["error", { "before": "always", "after": "never" }] */
 
-/* Top of file */
 // comment
 
 "use strict";
-"use asm";
 var foo;
 
 function foo() {
@@ -344,6 +388,20 @@ function foo() {
 
 :::
 
+::: correct { "sourceType": "script" }
+
+```js
+/* eslint lines-around-directive: ["error", { "before": "always", "after": "never" }] */
+
+// comment
+
+"use strict";
+"use asm";
+var foo;
+```
+
+:::
+
 ## When Not To Use It
 
 You can safely disable this rule if you do not have any strict conventions about whether or not directive prologues should have blank newlines before or after them.
diff --git a/docs/src/rules/max-statements-per-line.md b/docs/src/rules/max-statements-per-line.md
@@ -76,7 +76,7 @@ if (condition) { bar = 1; } else { baz = 2; }
 for (var i = 0; i < length; ++i) { bar = 1; baz = 2; }
 switch (discriminant) { case 'test': break; default: break; }
 function foo() { bar = 1; baz = 2; }
-var qux = function qux() { bar = 1; };
+var qux = function qux() { bar = 1; baz = 2; };
 (function foo() { bar = 1; baz = 2; })();
 ```
 
diff --git a/docs/src/rules/max-statements.md b/docs/src/rules/max-statements.md
diff --git a/docs/src/rules/no-multiple-empty-lines.md b/docs/src/rules/no-multiple-empty-lines.md
diff --git a/docs/src/rules/one-var.md b/docs/src/rules/one-var.md
