(MicrosoftDocsGH-70) Add AvoidSemiColonsAsLineTerminators (Microsof…

…tDocs#86)

This change adds the new `AvoidSemiColonsAsLineTerminators` rule
documentation to PSScriptAnalyzer.

- Resolves MicrosoftDocs#70
- Fixes AB#4588

reference/docs-conceptual/PSScriptAnalyzer/Rules/AvoidSemicolonsAsLineTerminators.md

@@ -0,0 +1,58 @@
+---
+description: Avoid semicolons as line terminators
+ms.custom: PSSA v1.21.0
+ms.date: 07/25/2022
+ms.topic: reference
+title: AvoidSemicolonsAsLineTerminators
+---
+
+# AvoidSemicolonsAsLineTerminators
+
+**Severity Level: Warning**
+
+## Description
+
+Lines should not end with a semicolon.
+
+> [!NOTE]
+> This rule is not enabled by default. The user needs to enable it through settings.
+
+## Example
+
+### Wrong
+
+```powershell
+Install-Module -Name PSScriptAnalyzer; $a = 1 + $b;
+```
+
+```powershell
+Install-Module -Name PSScriptAnalyzer;
+$a = 1 + $b
+```
+
+### Correct
+
+```powershell
+Install-Module -Name PSScriptAnalyzer; $a = 1 + $b
+```
+
+```powershell
+Install-Module -Name PSScriptAnalyzer
+$a = 1 + $b
+```
+
+## Configuration
+
+```powershell
+Rules = @{
+    PSAvoidSemicolonsAsLineTerminators  = @{
+        Enable     = $true
+    }
+}
+```
+
+### Parameters
+
+#### Enable: bool (Default value is `$false`)
+
+Enable or disable the rule during ScriptAnalyzer invocation.

reference/docs-conceptual/PSScriptAnalyzer/Rules/README.md

@@ -23,6 +23,7 @@ The PSScriptAnalyzer contains the following rule definitions.
 | [AvoidMultipleTypeAttributes<sup>1</sup>](./AvoidMultipleTypeAttributes.md)                       | Warning     |        Yes         |                 |
 | [AvoidNullOrEmptyHelpMessageAttribute](./AvoidNullOrEmptyHelpMessageAttribute.md)                 | Warning     |        Yes         |                 |
 | [AvoidOverwritingBuiltInCmdlets](./AvoidOverwritingBuiltInCmdlets.md)                             | Warning     |        Yes         |       Yes       |
+| [AvoidSemicolonsAsLineTerminators](./AvoidSemicolonsAsLineTerminators.md)                         | Warning     |         No         |                 |
 | [AvoidShouldContinueWithoutForce](./AvoidShouldContinueWithoutForce.md)                           | Warning     |        Yes         |                 |
 | [AvoidTrailingWhitespace](./AvoidTrailingWhitespace.md)                                           | Warning     |        Yes         |                 |
 | [AvoidUsingCmdletAliases](./AvoidUsingCmdletAliases.md)                                           | Warning     |        Yes         | Yes<sup>2</sup> |

reference/docs-conceptual/toc.yml

@@ -65,6 +65,8 @@ items:
             href: PSScriptAnalyzer/Rules/AvoidNullOrEmptyHelpMessageAttribute.md
           - name: AvoidOverwritingBuiltInCmdlets
             href: PSScriptAnalyzer/Rules/AvoidOverwritingBuiltInCmdlets.md
+          - name: AvoidSemicolonsAsLineTerminators
+            href: PSScriptAnalyzer/Rules/AvoidSemicolonsAsLineTerminators.md
           - name: AvoidShouldContinueWithoutForce
             href: PSScriptAnalyzer/Rules/AvoidShouldContinueWithoutForce.md
           - name: AvoidTrailingWhitespace