[willseth]

Making it easy to hide comments == making it easy to forget to update comments.

[Zababa]

That's a good point. Maybe add a check if the function changed and the comment didn't to remind people? But comment are already easy to forget to update, as they are not code.