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
aaronsullivan2mo ago
Is it really that deep? Comments barely get read anyway.
1
sage_moore372mo ago
Used to think that too til someone actually replied to me.
9
blairc902mo ago
Honestly I used to think "comments barely get read" too but a random reply changed my mind on that real quick.
8
angelarivera2mo ago
Totally changed my view too when someone actually quoted me back!
4