Update output documentation for cmdlets to clarify return types and conditions

Author: johlju

.github/instructions/dsc-community-style-guidelines-pester.instructions.md

@@ -28,7 +28,7 @@ applyTo: "**/*.[Tt]ests.ps1"
 - Mock variables prefix: 'mock'
 
 ## Structure & Scope
-- Public commands: Never use `InModuleScope` (unless retrieving localized strings)
+- Public commands: Never use `InModuleScope` (unless retrieving localized strings or creating an object using an internal class)
 - Private functions/class resources: Always use `InModuleScope`
 - Each class method = separate `Context` block
 - Each scenario = separate `Context` block

source/Public/Add-SqlDscFileGroup.ps1

@@ -21,12 +21,19 @@
         Specifies that the FileGroup should be added without confirmation.
 
     .INPUTS
-        [Microsoft.SqlServer.Management.Smo.FileGroup]
+        Microsoft.SqlServer.Management.Smo.FileGroup
 
         FileGroup objects that will be added to the Database.
 
     .OUTPUTS
-        None, or [Microsoft.SqlServer.Management.Smo.FileGroup[]] if PassThru is specified.
+        None
+
+        This cmdlet does not generate output by default.
+
+    .OUTPUTS
+        Microsoft.SqlServer.Management.Smo.FileGroup[]
+
+        When the PassThru parameter is specified, returns the FileGroup objects that were added.
 
     .EXAMPLE
         Add-SqlDscFileGroup -Database $database -FileGroup $fileGroup

source/Public/New-SqlDscDataFile.ps1

@@ -105,9 +105,19 @@
         Creates a DatabaseFileSpec object with all properties set directly via parameters.
 
     .OUTPUTS
-        None. Unless -PassThru is specified for the Standard or FromSpec parameter
-        sets, in which case it returns `[Microsoft.SqlServer.Management.Smo.DataFile]`.
-        When using the -AsSpec parameter, always returns `[DatabaseFileSpec]`.
+        None
+
+        This cmdlet does not generate output by default when using Standard or FromSpec parameter sets without PassThru.
+
+    .OUTPUTS
+        Microsoft.SqlServer.Management.Smo.DataFile
+
+        When using the Standard or FromSpec parameter sets with the PassThru parameter.
+
+    .OUTPUTS
+        DatabaseFileSpec
+
+        When using the AsSpec parameter to create a specification object.
 #>
 function New-SqlDscDataFile
 {

source/Public/New-SqlDscFileGroup.ps1

@@ -73,7 +73,14 @@
         Creates a DatabaseFileGroupSpec object with files and properties set directly via parameters.
 
     .OUTPUTS
-        `[Microsoft.SqlServer.Management.Smo.FileGroup]` or `[DatabaseFileGroupSpec]` if -AsSpec is specified.
+        Microsoft.SqlServer.Management.Smo.FileGroup
+
+        When creating a FileGroup with or without an associated Database (not using -AsSpec).
+
+    .OUTPUTS
+        DatabaseFileGroupSpec
+
+        When using the -AsSpec parameter to create a specification object.
 #>
 function New-SqlDscFileGroup
 {