Sarcasm aside, yes, I 100% agree with you.

When the "why" isn't explained, you end up with things like someone refactoring code and spending time (at best) trying to figure out why some tests now fail or (at worst) breaking something in production.

I'd argue that even the "how" sometimes is better explained in plain words than in code (even if that opens the door for outdated comments when code is changed).

Sometimes I wonder if I really do just need to add /s every time I'm being sarcastic.

Sometimes I think that people who can't write well enough to convey sarcasm when they mean it should just avoid using it and say what they mean.

Now that looks like sarcasm.

Unfortunately HN does not support use of the Sarcasm font.

/s