[RotsiserMho]

This. So much. Declaring intent (what) is much more useful than declaring the mechanics (how). I don't typically care about the "how", just the "what". And the more readable that is, the better.

[yvsong]

And the source code comments are the why.