The short comment will appear in the Task Pane with a leading # symbol. Comments are for documentation purposes only and serve no operational function.
The long comment is only visible when you edit the function step. You can include multiple lines of text in the long comment.
Notes In Other Function Wizards
[New in v10] In many function wizards, there is a Notes field at the bottom that can be used to insert a comment following the function name in the macro.
Updated for v10.