3 ms·
The code is the "how", sometimes it's necessary to explain the "why".
by cratermoon 1y ago
The code is the "how",
sometimes it's necessary to explain the "why".
- rkomorn 1y agoSometimes I wonder if I really do just need to add /s every time I'm being sarcastic.
- cratermoon 1y agoSometimes 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.
- rkomorn 1y agoSarcasm 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).