News for hackers. Stuff that matters.
Re:Keep your source code SIMPLE by sys_64738 on Sunday November 10, 2019 @12:28PM (#21499007)
Comment the why, not the what.
Re:Keep your source code SIMPLE by pytester on Sunday November 10, 2019 @02:49PM (#21499775)
It's good to comment the what too if it's hard to discern what it's doing from the code.

There have been a number of cases where, for instance, I had to call a bizarrely named API and do something unexpected in order to get an unintuitive outcome and in that case a "what" comment isn't such a bad idea.

Re:Keep your source code SIMPLE by tln on Sunday November 10, 2019 @02:58PM (#21499827)
Comment the intentions and motivations for behavior.