News for hackers. Stuff that matters.

A comment on We should revisit literate programming in the agent era. Parent comment

Re:We should revisit literate programming in the agent era by deathanatos on Monday March 09, 2026 @02:18AM (#47305421)
> what ensures that ‘// used a suboptimal sort because reasons’ is updated during a global refactor that changes the method?

And for that matter, what ensures it is even correct the first time it is written?

(I think this is probably the far more common problem when I'm looking at a bug, newly discovered: the logic was broken on day 1, hasn't changed since; the comment, when there is one, is as wrong as the day it was written.)

[ Parent | on HN ]
Re:We should revisit literate programming in the agent era by awesome_dude on Monday March 09, 2026 @03:20AM (#47305771)
But, you've still got an idea of why things were done the way they were - radio silence is....

Go ask Steve, he wrote it, oh, he left about 3 years ago... does anyone know what he was thinking?

[ Parent | on HN ]