Ah OK I see what I call "what" you call "why". "otherwise comments get outdated easily" - not mine. If this is a problem, it's a problem that needs fixing, not

Ah OK I see what I call "what" you call "why". "otherwise comments get outdated easily" - not mine. If this is a problem, it's a problem that needs fixing, not a reason to comment less. "extract that piece of code into a method" Sometimes, yes, but you can overdo this and end up with a fragmented codebase that is harder to follow. This is an old debate, and there are books on either side. My preference is something approaching Knuth's literate programming.