i think they don't use static code analysis on this part :) generally agree on commenting, but it's also about discipline - method-level commands are rarely up

i think they don't use static code analysis on this part :) generally agree on commenting, but it's also about discipline - method-level commands are rarely updated, but if there is some particular algorithm within method, I don't see a reason to describe it beforehand on a line or two. General rule - if method is longer than my screen, it's time to refactor. very rarely this isn't a good idea.