Clear code and clear tests shows both the what and the why. With the additional advantage that they can’t diverge and be out of sync like the comments because o

Clear code and clear tests shows both the what and the why. With the additional advantage that they can’t diverge and be out of sync like the comments because otherwise the tests will fail. Comments should be used to explain something unexpected. Commenting each line of code is a recipe for disaster.