News for hackers. Stuff that matters.
Re:Please do not attempt to simplify this code by chrisweekly on Thursday December 27, 2018 @06:09PM (#18773484)
Agreed. Also, comments that emphasize the "why" over the "what" are not obviated by descriptive names.
Re:Please do not attempt to simplify this code by tetha on Saturday December 29, 2018 @04:43AM (#18782865)
I've found it very helpful to rubber duck comments to get into the right why mode. Consider how you'd explain this piece of code to a less experienced guy on the team - and write down exactly that. Why was this added? Why was the old thing in place changed, what broke and had to be changed? Why didn't you do the other obvious thing? And remember - usually you should explain something until it's clear for you, and then one more step.