Comment by coldbrewed
5 hours ago
We shouldn't tolerate slop in any form, especially not in commit comments. What we should care about is communicating design decisions, intent, and especially we should explain concerns that can't be intuited from reading the code. A longer, more detailed comment that explains some significant detail can be especially valuable but it should earn the weight that it carries.
I think we're all in agreement that a one word "runs" commit and a 6 paragraph slop commit both fail to communicate effectively.
No comments yet
Contribute on Hacker News ↗