News for hackers. Stuff that matters.
Re:Please do not attempt to simplify this code by TeMPOraL on Friday December 28, 2018 @01:45AM (#18775225)
How soon? I've rarely seen it happen in a meaningful way (i.e. other than someone using automated refactoring on some name, and breaking some comment reference that wasn't written in a way the autorefactor tool could read). When it happens and you see it, you should fix it like any other bug.

Key trick is writing comments as close as possible to the code they affect. Then it's hard to miss affected comments if one's not doing a shoddy job.

Re:Please do not attempt to simplify this code by dllthomas on Friday December 28, 2018 @01:27PM (#18778485)
> Key trick is writing comments as close as possible to the code they affect. Then it's hard to miss affected comments if one's not doing a shoddy job.

That also helps it show up in a PR so it may be caught in code review. Even so, IME comments get missed enough that over time I can't be as confident as we'd like that they match the code.

I think it's also worth calling out that this key trick is not being applied in the recommendation up-thread, which asks for a block comment at the top of the module.

Re:Please do not attempt to simplify this code by tome on Friday December 28, 2018 @05:41AM (#18776040)
I've done it frequently myself when I've changed a line that I originally wrote myself in a way that invalidates a comment written directly above.