News for hackers. Stuff that matters.
Re:On Comments in Code by ozim on Tuesday June 15, 2021 @06:06PM (#27522146)
It is not about my team.

It is about people. In the world where team members last ~2 years and move on, expecting that documentation is left not updated is in my opinion perfectly valid assumption.

Re:On Comments in Code by pjerem on Wednesday June 16, 2021 @04:55AM (#27526376)
I was not directing my comment to your coworkers. I was just arguing that a documentation can only be out of sync if the method's intention is changed. And if an existing method intention is changed, your problem is not the out of sync documentation, but the fact you probably broke something in your existing code, not in the years to come, but today.