News for hackers. Stuff that matters.
Re:It's probably time to stop recommending Clean Code (2020) by barrkel on Tuesday May 25, 2021 @05:22PM (#27282857)
Function names are comments, and have similar failure modes.
Re:It's probably time to stop recommending Clean Code (2020) by gilbetron on Tuesday May 25, 2021 @08:21PM (#27284580)
Comments that are limited to only a 2 or 3 dozen characters at most, so worse than comments ime.
Re:It's probably time to stop recommending Clean Code (2020) by nojokes on Tuesday May 25, 2021 @11:17PM (#27285828)
You can put your prose at the top of the function if you really need to explain it more. :)
Re:It's probably time to stop recommending Clean Code (2020) by ric2b on Friday May 28, 2021 @12:54PM (#27317748)
But it's easier to notice they're outdated, because you don't see them only when looking at the implementation.