You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This is more of a nit FR, but it would be performant to leverage the platyPS Update-MarkdownHelp function over the New-MarkdownHelp function when generating documentation.
If the doc already exists for a given function, leverage Update-MarkdownHelp function over the New-MarkdownHelp function. This can be done with a PowerShell foreach loop and nested conditional.
Describe any alternatives you've considered
New-Markdownhelp technically works, but it seems unnecessary to generate entirely new documentation files every time this module is built, especially if the function(s) have not been updated.
Description
This is more of a nit FR, but it would be performant to leverage the platyPS
Update-MarkdownHelp
function over theNew-MarkdownHelp
function when generating documentation.Update-MarkdownHelp doc: https://github.com/PowerShell/platyPS/blob/master/docs/Update-MarkdownHelp.md
New-MarkdownHelp doc: https://github.com/PowerShell/platyPS/blob/master/docs/New-MarkdownHelp.md
Describe the solution you'd like
If the doc already exists for a given function, leverage
Update-MarkdownHelp
function over theNew-MarkdownHelp
function. This can be done with a PowerShellforeach
loop and nested conditional.Describe any alternatives you've considered
New-Markdownhelp
technically works, but it seems unnecessary to generate entirely new documentation files every time this module is built, especially if the function(s) have not been updated.Additional context
See platyPS module documentation here: https://github.com/PowerShell/platyPS
The text was updated successfully, but these errors were encountered: