I think we can use line comments (//) for this comment here and the param doesn't need to be documented, since the function is an ordinary callback and doesn't declare anything. For directive, class methods, etc we can/should use block comments.