V
27

Vent: Forgetting to comment your code is like not labeling leftovers in the fridge

I just spent an hour trying to figure out what my own script does because I didn't leave any notes (talk about a beginner's mistake).
3 comments

Log in to join the discussion

Log In
3 Comments
amy_coleman
Disagree, good code explains itself without notes.
6
dakota_moore
That leftover metaphor is perfect, it really is the same feeling. Opening your own code six months later and it's just a wall of weird gibberish. You sit there staring, knowing you wrote this but having zero memory of why. The worst part is the time you waste just trying to remember your own plan, time you could have saved with two quick notes. Always end up promising to comment more, and then the cycle repeats.
3
ryanc71
ryanc712d ago
Three hours I'll never get back, same promise every time.
1