Updated rule documentation

Author: iRon7

docs/Rules/AvoidUsingNewObject.md

@@ -4,13 +4,11 @@ ms.date: 06/06/2026
 ms.topic: reference
 title: AvoidUsingNewObject
 ---
-<!-- markdownlint-disable MD025 -->
 # AvoidUsingNewObject
-<!-- markdownlint-enable MD025 -->
 
-<!-- markdownlint-disable MD036 -->
 **Severity Level: Warning**
-<!-- markdownlint-enable MD036 -->
+
+**Default state: Disabled**
 
 ## Description
 
@@ -19,15 +17,27 @@ Instead, use a type initializer to construct or cast the intended object.
 
 ## Example
 
-### Wrong
+### Noncompliant
 
 ```powershell
 # Create a version object using New-Object
 $Version = New-Object -TypeName Version -ArgumentList "1.2.3"
 ```
 
+### Compliant
+
+```powershell
+# Create a version object using the type constructor
+$Version = [Version]"1.2.3"
+```
+
+## Examples
+
+### Creating multiple Custom Objects
+
+#### Noncompliant
+
 ```powershell
-# Create a custom object using New-Object
 for ($i = 0; $i -lt 100000; $i++) {
     $resultObject = New-Object PSCustomObject -Property @{
         Name = "Name$i"
@@ -36,19 +46,9 @@ for ($i = 0; $i -lt 100000; $i++) {
 }
 ```
 
-```powershell
-$hashSet = New-Object -TypeName 'System.Collections.Generic.HashSet[String]' -ArgumentList ([StringComparer]::InvariantCultureIgnoreCase)
-```
-
-### Correct
+#### Compliant
 
 ```powershell
-# Create a version object using the type constructor
-$Version = [Version]"1.2.3"
-```
-
-```powershell
-# Create a custom object using a hashtable and type-casting
 for ($i = 0; $i -lt 100000; $i++) {
     $resultObject = [PSCustomObject]@{
         Name = "Name$i"
@@ -57,11 +57,24 @@ for ($i = 0; $i -lt 100000; $i++) {
 }
 ```
 
+### Creating a case-insensitive HashSet
+
+#### Noncompliant
+
 ```powershell
-$hashSet = [System.Collections.Generic.HashSet[String]]::new([StringComparer]::InvariantCultureIgnoreCase)
+$hashSet = New-Object -TypeName 'System.Collections.Generic.HashSet[String]' -ArgumentList ([StringComparer]::InvariantCultureIgnoreCase)
+```
+
+#### Compliant
+
+```powershell
+$hashSet = [System.Collections.Generic.HashSet[String]]::new([StringComparer]:::InvariantCultureIgnoreCase)
 ```
 
-## Configuration
+## Configure rule
+
+This rule is disabled by default, but can be enabled by adding the following
+configuration to your `PSScriptAnalyzerSettings.psd1` file:
 
 ```powershell
 Rules = @{
@@ -71,7 +84,7 @@ Rules = @{
 }
 ```
 
-### Parameters
+## Parameters
 
 - `Enable`: **bool** (Default value is `$false`)
 

global.json

@@ -1,6 +1,6 @@
 {
     "sdk": {
-        "version": "8.0.419",
+        "version": "8.0.425",
         "rollForward": "latestFeature"
     }
 }