logoalt Hacker News

smokel • today at 6:08 PM • 2 replies • view on HN

Code typically documents the "what" and "how", not the "why".

Why something exists, and how it connects to the outside world may be documented in comments, but more often than not it isn't.


Replies

arcanemachiner • today at 6:21 PM

And agents are pretty bad at inferring when to do, and often fall back to verbose clutterin the comments.

haukebri • today at 6:09 PM

[flagged]