Robert Cain helps those who help themselves:
Having good help is vital to the construction of a module. It explains not only how to use a function, but the purpose of the module and even more.
Naturally I’ve included good help text in the ArcaneBooks module, but as I was going over the construction of the ArcaneBooks module I realized I’d not written about how to write help in PowerShell. So in this post and the next I’ll address this very topic.
Read on for Robert’s thoughts on the topic, including standard ways to add content comments so Powershell’s built-in Get-Help
cmdlet works for you.