News for hackers. Stuff that matters.
Re:WebKit on GitHub by domenicd on Wednesday August 31, 2022 @07:28PM (#32669676)
There's some policy about comments being bad / code should be self documenting.

From what I hear from my colleagues on the Chrome team, one of the first things they were delighted to do after forking Blink was to finally go around and comment the various confusing parts of the codebase. (And, no longer get requests to remove comments when trying to land a PR.)

Re:WebKit on GitHub by habosa on Thursday September 01, 2022 @07:50AM (#32675070)
I've met some very smart and capable programmers who perpetuate this "style". It's so harmful. Comments are good for the writer AND the reader.
Re:WebKit on GitHub by doe88 on Thursday September 01, 2022 @02:38PM (#32680991)
Thanks, for the reply, what such a weird policy. I found it so uncanny at first, that I even thought that they had somehow internally a system where they were able to automatically merge some comments and documentation with their source files.