• 0 Posts
  • 201 Comments
Joined 1 year ago
cake
Cake day: June 16th, 2023

help-circle




  • I retired as a programmer five years ago and now I drive a school bus. The difference in acceptable workplace behavior is pretty stark. In my software companies, nobody ever came anywhere close to saying anything even vaguely racist; meanwhile in the bus garage people routinely use the n-word and the g-word. And it’s not like this is Mississippi or anything - this is a suburb of Philadelphia where the entire transportation department would probably be sacked if parents were ever to become aware of how their bus drivers talk.











  • if the code changes and the comment isn’t updated accordingly, it can be ambiguous.

    People always cite this as a reason comments are bad. In 30+ years as a developer I have seen (and participated in) a lot of failed software projects, but not once has a mismatch between comments and code been the actual cause of the failure. Moreover, the same logic could be applied to the names of methods and variables (“if the code changes and the method and variable names aren’t updated accordingly, it can be ambiguous”) but nobody ever suggests getting rid of that. At the end of the day, comments are useful for imparting information about the code to future developers (or yourself) that is too complicated to be adequately communicated by a method name.