From a754b950467aa9e78a1eba1a3423bbd055ed8772 Mon Sep 17 00:00:00 2001
From: Sean Wheeler <sean.wheeler@microsoft.com>
Date: Wed, 27 Mar 2024 11:12:57 -0500
Subject: [PATCH] Sync docs changes from
 MicrosoftDocs/PowerShell-Docs-Modules#213 (#1987)

---
 docs/Rules/README.md           |  6 +++---
 docs/Rules/UseSingularNouns.md | 16 ++++++++--------
 2 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/docs/Rules/README.md b/docs/Rules/README.md
index b5761acaf..4f0d24e68 100644
--- a/docs/Rules/README.md
+++ b/docs/Rules/README.md
@@ -1,7 +1,7 @@
 ---
 description: List of PSScriptAnalyzer rules
 ms.custom: PSSA v1.22.0
-ms.date: 02/13/2024
+ms.date: 03/27/2024
 ms.topic: reference
 title: List of PSScriptAnalyzer rules
 ---
@@ -58,7 +58,7 @@ The PSScriptAnalyzer contains the following rule definitions.
 | [ProvideCommentHelp](./ProvideCommentHelp.md)                                                     | Information |        Yes         |       Yes       |
 | [ReservedCmdletChar](./ReservedCmdletChar.md)                                                     | Error       |        Yes         |                 |
 | [ReservedParams](./ReservedParams.md)                                                             | Error       |        Yes         |                 |
-| [ReviewUnusedParameter](./ReviewUnusedParameter.md)                                               | Warning     |        Yes         |                 |
+| [ReviewUnusedParameter](./ReviewUnusedParameter.md)                                               | Warning     |        Yes         | Yes<sup>2</sup> |
 | [ShouldProcess](./ShouldProcess.md)                                                               | Warning     |        Yes         |                 |
 | [UseApprovedVerbs](./UseApprovedVerbs.md)                                                         | Warning     |        Yes         |                 |
 | [UseBOMForUnicodeEncodedFile](./UseBOMForUnicodeEncodedFile.md)                                   | Warning     |        Yes         |                 |
@@ -84,5 +84,5 @@ The PSScriptAnalyzer contains the following rule definitions.
 
 - <sup>1</sup> Rule is not available on all PowerShell versions, editions, or OS platforms. See the
   rule's documentation for details.
-- <sup>2</sup> The rule a configurable property, but the rule can't be disabled like other
+- <sup>2</sup> The rule has a configurable property, but the rule can't be disabled like other
   configurable rules.
diff --git a/docs/Rules/UseSingularNouns.md b/docs/Rules/UseSingularNouns.md
index cde3b7028..b7bba39eb 100644
--- a/docs/Rules/UseSingularNouns.md
+++ b/docs/Rules/UseSingularNouns.md
@@ -1,7 +1,7 @@
 ---
 description: Cmdlet Singular Noun
 ms.custom: PSSA v1.22.0
-ms.date: 03/26/2024
+ms.date: 03/27/2024
 ms.topic: reference
 title: UseSingularNouns
 ---
@@ -25,24 +25,24 @@ function Get-Elements {
 
 ```powershell
 Rules = @{
-    UseSingularNouns = @{
-        NounAllowList    = 'Data', 'Windows', 'Foos'
+    PSUseSingularNouns = @{
         Enable           = $true
+        NounAllowList    = 'Data', 'Windows', 'Foos'
     }
 }
 ```
 
 ### Parameters
 
-- `UseSingularNouns`: `string[]` (Default value is `{'Data', 'Windows'}`)
-
-  Commands to be excluded from this rule. `Data` and `Windows` are common false positives and are
-  excluded by default.
-
 - `Enable`: `bool` (Default value is `$true`)
 
   Enable or disable the rule during ScriptAnalyzer invocation.
 
+- `NounAllowList`: `string[]` (Default value is `{'Data', 'Windows'}`)
+
+  Commands to be excluded from this rule. `Data` and `Windows` are common false positives and are
+  excluded by default.
+
 ## How
 
 Change plurals to singular.