Clarify guidelines on plural parameter names (#28605)

isra-fel · web-flow · commit 451e7630fd2f · 2025-09-23T16:29:20.000+08:00
diff --git a/documentation/development-docs/design-guidelines/parameter-best-practices.md b/documentation/development-docs/design-guidelines/parameter-best-practices.md
@@ -60,6 +60,8 @@ From the [_Strongly Encouraged Development Guidelines_](https://learn.microsoft.
 >
 > _Plural parameter names should be used only in those cases where the value of the parameter is always a multiple-element value. In these cases, the cmdlet should verify that multiple elements are supplied, and the cmdlet should display a warning to the user if multiple elements are not supplied._
 
+A common exception to this guideline is with units, e.g. `-IntervalInSeconds`, `-MaxSizeInMegabytes`.
+
 #### Parameter Alias
 
 If you there is a separate nomenclature for the parameter name, or if you would like to shorten the name of the parameter so it's easier to remember, you can add an alias attribute to your parameter to allow for this functionality.

Original file line number	Diff line number	Diff line change
`@@ -60,6 +60,8 @@ From the [_Strongly Encouraged Development Guidelines_](https://learn.microsoft.`
`60`	`60`	`>`
`61`	`61`	`> _Plural parameter names should be used only in those cases where the value of the parameter is always a multiple-element value. In these cases, the cmdlet should verify that multiple elements are supplied, and the cmdlet should display a warning to the user if multiple elements are not supplied._`
`62`	`62`
	`63`	+A common exception to this guideline is with units, e.g. `-IntervalInSeconds`, `-MaxSizeInMegabytes`.
	`64`	`+`
`63`	`65`	`#### Parameter Alias`
`64`	`66`
`65`	`67`	`If you there is a separate nomenclature for the parameter name, or if you would like to shorten the name of the parameter so it's easier to remember, you can add an alias attribute to your parameter to allow for this functionality.`