News for hackers. Stuff that matters.
Re:On navigating a large codebase by bluefirebrand on Sunday February 14, 2021 @06:41PM (#26137392)
Sure but which is more likely:

Someone updating the comments in code that they are updating because they see the comments right in front of them.

Or

Someone going to look through the documentation to see if there is anything relevant about the code they are working on that needs to be updated.

Re:On navigating a large codebase by atomashpolskiy on Monday February 15, 2021 @04:50AM (#26141030)
Somewhat surprisingly, it depends. For instance, in our case application support is responsible for/interested in the documentation, and they make sure that developers create/update the relevant documentation for each of the release items. Stale comments, on the other hand, need to be identified and addressed in code reviews, and in practice we're not always good at that.