How should a PowerShell module document its error behavior?
I maintain a PowerShell module with about 40 exported provisioning functions. I recently reviewed all 127 places where those functions report or handle errors: 52 used string-based throw,…
comment-based help
How should a PowerShell module document whether errors terminate or continue?
I maintain a PowerShell module with roughly 40 exported provisioning functions. After auditing 127 error paths, I found four different behaviors: 52 used throw with a string, 34…
Why does valid comment-based help omit aliases and parameter metadata?
I'm updating some older PowerShell functions with comment-based help and noticed that Get-Help -Full does not always show all the command metadata. With a normal help block, the…