hypnotic_nerd@programming.dev to Programmer Humor@programming.devEnglish · 2 years agoManager: This task only takes 30 minutes. Why did it take you the whole day?programming.devimagemessage-square117fedilinkarrow-up1805arrow-down18
arrow-up1797arrow-down1imageManager: This task only takes 30 minutes. Why did it take you the whole day?programming.devhypnotic_nerd@programming.dev to Programmer Humor@programming.devEnglish · 2 years agomessage-square117fedilink
minus-squaredeadbeef79000@lemmy.nzlinkfedilinkarrow-up7·edit-22 years agoP1000x this. I can read a diff. I need to know why. No, a code comment isn’t good enough, it’s out of date after the next commit.
minus-squareDontTakeMySky@lemmy.worldlinkfedilinkarrow-up0·2 years agoCode comments for "why"s that persist. Commits for why’s that are temporary. If you need to run X before Y, add a comment. If you added X before why because it was easier, leave it in a commit
minus-squaredeadbeef79000@lemmy.nzlinkfedilinkarrow-up1·2 years ago If you need to run X before Y… Add a test that asserts that.
P1000x this.
I can read a diff.
I need to know why.
No, a code comment isn’t good enough, it’s out of date after the next commit.
Code comments for "why"s that persist. Commits for why’s that are temporary.
If you need to run X before Y, add a comment. If you added X before why because it was easier, leave it in a commit
Add a test that asserts that.