Re:Why developers need to be able to identify technologies w...
by davidjnelson on Monday June 25, 2018 @08:16PM
(#17396977)
I agree it's a great idea to leave comments in code, for things that are done in a non obvious way for good reasons.
Both of these are red flags. Sure, I can learn how to steer around all the potholes. But so will everyone else who works on the project. Eventually someone will miss some important detail, or go on a refactoring expedition and end up removing a bunch of what appears to be excess complication but is actually a carefully constructed workaround for some wart in the system (the comment explaining this having long since been deleted - or maybe migrated to the team wiki, where all good information goes to die - by someone who had been watching a lot of Uncle Bob videos on YouTube at the time), and then production bugs sneak in, and eventually people quite rationally start to blame the technology.