3
Just realized my code comments were useless after a senior dev read them out loud
I was putting comments like 'this loops through the array' on every single line. Last Tuesday a senior dev pulled me aside and read three of them back to me, then asked 'what does this actually do?' Now I write comments explaining why I did something weird, not what the code already says. Has anyone else had their comment style wrecked by one specific piece of feedback?
4 comments
Log in to join the discussion
Log In4 Comments
aaronsullivan1mo ago
Is it really that deep? Comments barely get read anyway.
1
sage_moore371mo agoMost Upvoted
Used to think that too til someone actually replied to me.
9
blairc901mo agoMost Upvoted
Honestly I used to think "comments barely get read" too but a random reply changed my mind on that real quick.
8
angelarivera1mo ago
Totally changed my view too when someone actually quoted me back!
4