Update-MarkdownHelp doesn't respect, in some cases, an order of params (#423)

Author: it-praktyk

docs/Update-MarkdownHelp.md

@@ -231,6 +231,8 @@ You can pipe an array of paths to this cmdlet.
 This cmdlet returns a **FileInfo[]** object for updated files.
 
 ## NOTES
+The module for which you want to update the help should first be imported from the location containing the previous version of the help.
+If this condition is not met, the parameter order will be alphabetical in the updated help, even if the parameter *AlphabeticParamsOrder* has not been used.
 
 ## RELATED LINKS
 

docs/Update-MarkdownHelpModule.md

@@ -238,6 +238,8 @@ You can pipe an array of paths to this cmdlet.
 This cmdlet returns a **FileInfo[]** object for updated and new files.
 
 ## NOTES
+The module for which you want to update the help should first be imported from the location containing the previous version of the help.
+ If this condition is not met, the parameter order will be alphabetical in the updated help, even if the parameter *AlphabeticParamsOrder* has not been used.
 
 ## RELATED LINKS
 

src/platyPS/platyPS.Resources.psd1

@@ -74,4 +74,5 @@ WhatIf = Shows what would happen if the cmdlet runs. The cmdlet is not run.
 Skip = Ignores the specified number of objects and then gets the remaining objects. Enter the number of objects to skip.
 First = Gets only the specified number of objects. Enter the number of objects to get.
 IncludeTotalCount = Reports the total number of objects in the data set (an integer) followed by the selected objects. If the cmdlet cannot determine the total count, it displays "Unknown total count." The integer has an Accuracy property that indicates the reliability of the total count value. The value of Accuracy ranges from 0.0 to 1.0 where 0.0 means that the cmdlet could not count the objects, 1.0 means that the count is exact, and a value between 0.0 and 1.0 indicates an increasingly reliable estimate.
+ModuleImporteAutomaticaly = The module {0} was imported automatically. It may cause that parameters will be sorted alphabetically even without usage of the parameter AlphabeticParamsOrder. Please be sure that the loaded module instance contains previously generated help to avoid that.
 '@

src/platyPS/platyPS.psm1

@@ -240,7 +240,7 @@ function New-MarkdownHelp
         if ($PSCmdlet.ParameterSetName -eq 'FromCommand')
         {
             $command | ForEach-Object {
-                if (-not (Get-Command $_ -EA SilentlyContinue))
+                if (-not (Get-Command $_ -ErrorAction SilentlyContinue))
                 {
                     throw $LocalizedData.CommandNotFound -f $_
                 }
@@ -421,6 +421,7 @@ function Update-MarkdownHelp
             $oldModel = $oldModels[0]
 
             $name = $oldModel.Name
+            [Array]$loadedModulesBefore = $(Get-Module | Select-Object -Property Name)
             $command = Get-Command $name -ErrorAction SilentlyContinue
             if (-not $command)
             {
@@ -435,6 +436,10 @@ function Update-MarkdownHelp
                     return
                 }
             }
+            elseif (($null -ne $command.ModuleName) -and ($loadedModulesBefore.Name -notcontains $command.ModuleName))
+            {
+                log -warning ($LocalizedData.ModuleImporteAutomaticaly -f $($command.ModuleName))
+            }
 
             # update the help file entry in the metadata
             $metadata = Get-MarkdownMetadata $filePath