PSSA 1.21.0 docs changes from PSSA repo

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

@@ -1,6 +1,6 @@
 ---
 description: Align assignment statement
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AlignAssignmentStatement

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

@@ -1,6 +1,6 @@
 ---
 description: Changing automatic variables might have undesired side effects
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidAssignmentToAutomaticVariable

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

@@ -1,6 +1,6 @@
 ---
 description: Avoid Default Value For Mandatory Parameter
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidDefaultValueForMandatoryParameter

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

@@ -1,6 +1,6 @@
 ---
 description: Switch Parameters Should Not Default To True
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidDefaultValueSwitchParameter

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

@@ -1,6 +1,6 @@
 ---
 description: Avoid global aliases.
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidGlobalAliases

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

@@ -1,6 +1,6 @@
 ---
 description: Avoid global functions and aliases
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidGlobalFunctions

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

@@ -1,6 +1,6 @@
 ---
 description: No Global Variables
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidGlobalVars

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

@@ -1,6 +1,6 @@
 ---
 description: Avoid Invoking Empty Members
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidInvokingEmptyMembers

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

@@ -1,6 +1,6 @@
 ---
 description: Avoid long lines
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidLongLines

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

@@ -1,6 +1,6 @@
 ---
 description: Avoid multiple type specifiers on parameters.
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidMultipleTypeAttributes
@@ -12,7 +12,7 @@ title: AvoidMultipleTypeAttributes
 ## Description
 
 Parameters should not have more than one type specifier. Multiple type specifiers on parameters
-cause runtime errors.
+can cause runtime errors.
 
 ## How
 
@@ -28,14 +28,10 @@ function Test-Script
     [CmdletBinding()]
     Param
     (
-        [String]
-        $Param1,
-
         [switch]
-        [bool]
+        [int]
         $Switch
     )
-    ...
 }
 ```
 
@@ -47,12 +43,8 @@ function Test-Script
     [CmdletBinding()]
     Param
     (
-        [String]
-        $Param1,
-
         [switch]
         $Switch
     )
-    ...
 }
 ```

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

@@ -1,6 +1,6 @@
 ---
 description: Avoid using null or empty HelpMessage parameter attribute.
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidNullOrEmptyHelpMessageAttribute

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

@@ -1,6 +1,6 @@
 ---
 description: Avoid overwriting built in cmdlets
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidOverwritingBuiltInCmdlets

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

@@ -1,11 +1,10 @@
 ---
 description: Avoid semicolons as line terminators
 ms.custom: PSSA v1.21.0
-ms.date: 07/25/2022
+ms.date: 06/15/2022
 ms.topic: reference
 title: AvoidSemicolonsAsLineTerminators
 ---
-
 # AvoidSemicolonsAsLineTerminators
 
 **Severity Level: Warning**
@@ -14,8 +13,7 @@ title: AvoidSemicolonsAsLineTerminators
 
 Lines should not end with a semicolon.
 
-> [!NOTE]
-> This rule is not enabled by default. The user needs to enable it through settings.
+**Note**: This rule is not enabled by default. The user needs to enable it through settings.
 
 ## Example
 

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

@@ -1,6 +1,6 @@
 ---
 description: Avoid Using ShouldContinue Without Boolean Force Parameter
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidShouldContinueWithoutForce

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

@@ -1,6 +1,6 @@
 ---
 description: Avoid trailing whitespace
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidTrailingWhitespace

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

@@ -1,6 +1,6 @@
 ---
 description: Avoid Using Cmdlet Aliases or omitting the 'Get-' prefix.
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidUsingCmdletAliases

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

@@ -1,6 +1,6 @@
 ---
 description: Avoid Using ComputerName Hardcoded
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidUsingComputerNameHardcoded

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

@@ -1,6 +1,6 @@
 ---
 description: Avoid Using SecureString With Plain Text
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidUsingConvertToSecureStringWithPlainText

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

@@ -1,6 +1,6 @@
 ---
 description: Avoid Using Deprecated Manifest Fields
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidUsingDeprecatedManifestFields

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

@@ -1,6 +1,6 @@
 ---
 description: Avoid using double quotes if the string is constant.
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidUsingDoubleQuotesForConstantString

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

@@ -1,6 +1,6 @@
 ---
 description: Avoid Using Empty Catch Block
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidUsingEmptyCatchBlock

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

@@ -1,6 +1,6 @@
 ---
 description: Avoid Using Invoke-Expression
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidUsingInvokeExpression

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

@@ -1,6 +1,6 @@
 ---
 description: Avoid Using Plain Text For Password Parameter
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidUsingPlainTextForPassword

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

@@ -1,6 +1,6 @@
 ---
 description: Avoid Using Positional Parameters
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidUsingPositionalParameters

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

@@ -1,6 +1,6 @@
 ---
 description: Avoid Using Username and Password Parameters
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidUsingUsernameAndPasswordParams

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

@@ -1,6 +1,6 @@
 ---
 description: Avoid Using Get-WMIObject, Remove-WMIObject, Invoke-WmiMethod, Register-WmiEvent, Set-WmiInstance
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidUsingWMICmdlet
@@ -48,12 +48,12 @@ Change to the equivalent CIM based cmdlet.
 
 ```powershell
 Get-WmiObject -Query 'Select * from Win32_Process where name LIKE "myprocess%"' | Remove-WmiObject
-Invoke-WmiMethod ?Class Win32_Process ?Name "Create" ?ArgumentList @{ CommandLine = "notepad.exe" }
+Invoke-WmiMethod -Class Win32_Process -Name "Create" -ArgumentList @{ CommandLine = "notepad.exe" }
 ```
 
 ### Correct
 
 ```powershell
 Get-CimInstance -Query 'Select * from Win32_Process where name LIKE "myprocess%"' | Remove-CIMInstance
-Invoke-CimMethod ?ClassName Win32_Process ?MethodName "Create" ?Arguments @{ CommandLine = "notepad.exe" }
+Invoke-CimMethod -ClassName Win32_Process -MethodName "Create" -Arguments @{ CommandLine = "notepad.exe" }
 ```

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

@@ -1,6 +1,6 @@
 ---
 description: Avoid Using Write-Host
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: AvoidUsingWriteHost

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

@@ -1,6 +1,6 @@
 ---
 description: DSC examples are present
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: DSCDscExamplesPresent

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

@@ -1,6 +1,6 @@
 ---
 description: Dsc tests are present
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: DSCDscTestsPresent

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

@@ -1,6 +1,6 @@
 ---
 description: Return Correct Types For DSC Functions
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: DSCReturnCorrectTypesForDSCFunctions

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

@@ -1,6 +1,6 @@
 ---
 description: Use Standard Get/Set/Test TargetResource functions in DSC Resource
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: DSCStandardDSCFunctionsInResource

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

@@ -1,6 +1,6 @@
 ---
 description: Use identical mandatory parameters for DSC Get/Test/Set TargetResource functions
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: DSCUseIdenticalMandatoryParametersForDSC

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

@@ -1,6 +1,6 @@
 ---
 description: Use Identical Parameters For DSC Test and Set Functions
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: DSCUseIdenticalParametersForDSC

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

@@ -1,6 +1,6 @@
 ---
 description: Use verbose message in DSC resource
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: DSCUseVerboseMessageInDSCResource

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

@@ -1,6 +1,6 @@
 ---
 description: Misleading Backtick
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: MisleadingBacktick

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

@@ -1,6 +1,6 @@
 ---
 description: Module Manifest Fields
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: MissingModuleManifestField

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

@@ -1,6 +1,6 @@
 ---
 description: Place close braces
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: PlaceCloseBrace

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

@@ -1,6 +1,6 @@
 ---
 description: Place open braces consistently
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: PlaceOpenBrace

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

@@ -1,6 +1,6 @@
 ---
 description: Null Comparison
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: PossibleIncorrectComparisonWithNull

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

@@ -1,6 +1,6 @@
 ---
-description: Equal sign is not an assignment operator. Did you mean the equality operator '-eq'?
-ms.custom: PSSA v1.20.0
+description: Equal sign is not an assignment operator. Did you mean the equality operator \'-eq\'?
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: PossibleIncorrectUsageOfAssignmentOperator

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

@@ -1,6 +1,6 @@
 ---
 description: \'>\' is not a comparison operator. Use \'-gt\' (greater than) or \'-ge\' (greater or equal).
-ms.custom: PSSA v1.20.0
+ms.custom: PSSA v1.21.0
 ms.date: 10/18/2021
 ms.topic: reference
 title: PossibleIncorrectUsageOfRedirectionOperator