Expand a comment explaning common reasons for odd compile errors.

If there is a missmatch between the calling specification in the Invoke
method with the worklet operator, then you get very odd compile errors.
This change expands a comment that tries to explain common reasons for
such errors and things to check.
Merge branch 'compile-error-explanation'