Add an extended Snippet for Advanced Functions

[kilasuit]

PR Summary

fixes #5197

Added snippet from ISE with minor edits

• comment help inside instead of outside the function defintion
• added clean block and link to docs on this

Adding based on this comment on bsky

PR Checklist

Note: Tick the boxes below that apply to this pull request by putting an x between the square brackets.
Please mark anything not applicable to this PR NA.

• PR has a meaningful title
• Summarized changes
• PR has tests
• This PR is ready to merge and is not work in progress
  • If the PR is work in progress, please add the prefix WIP: to the beginning of the title and remove the prefix when the PR is ready

[JustinGrote]

Godo work on the snippet, I'm not quite sure how useful this is though, maybe it should be renamed Function-Advanced-Doc-Full-Example to indicate it is an example for all the potential options? I personally would never use this, it would take me just as long to clean it up as it would to just write it naked with intellisense :)

[kilasuit]

@JustinGrote this was a C&P from the one in ISE with very minor edits
But will take comments on board and push an update shortly

[JustinGrote]

I'll merge it either way, but good to make it as useful as possible yeah?

[JustinGrote]

Looks good to me, nice work!

[JustinGrote]

@andyleejordan not sure why it's waiting on codeql, I don't see it as an action...

[JustinGrote]

@andyleejordan bump on this.

[andyleejordan]

Thanks!

[JustinGrote]

Thanks @kilasuit!