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 dkersten on Monday March 09, 2026 @07:40AM (#47307749)
Code alone can never describe intent or rationale.
[ Parent | on HN ]
Re:We should revisit literate programming in the agent era by ithkuil on Monday March 09, 2026 @07:59AM (#47307925)
Indeed, you need both!

But documentation should not go too deep in the "how" otherwise it risks telling a lie after a while as the code changes but the documentation lags.

[ Parent | on HN ]