One of the things we all love about PowerShell is its help system. Like Linux’s man pages, PowerShell’s help files can provide information, examples, instructions, and more. So, we want to provide help with the tools we create—and you should too. You have two ways of doing so.
First is the easiest solution, which is comment-based help. You simply put the help files at the top of your scripts and functions, and PowerShell will interpret these as the help files. Second, an external help file is generally written in Markdown format. You can use modules such as PlatyPS to help create these files. For now, we’ll use the simpler, single-language, comment-based help inside your function.