Comment help snippet should optionally allow placement inside of function definition

[daviwil]

It seems there are a number of people requesting the ability for our new comment help snippet to place the help string inside of the function body. We should enable this to work there based on where the user is typing (above function, inside of function above param block, or bottom of function). Better to be smart about it and place it where the user is typing than making them set an option.

[pcgeek86]

You beat me to filing this bug. :)

[rkeithhill]

Choice is good. :-) Also, 👍 on making this dependent on where the user is typing instead of adding another setting.

[daviwil]

PSScriptAnalyzer can already do it, we've just got to wire it up :)

https://github.com/PowerShell/PSScriptAnalyzer/blob/development/RuleDocumentation/ProvideCommentHelp.md