logoalt Hacker News

Taikonerdtoday at 6:52 PM2 repliesview on HN

I find that Claude Code writes very long comments, longer than even a human trying to be helpful would write.

I figure that it's basically making notes for itself, when it has to revisit the same code in a fresh session.


Replies

pennomitoday at 8:47 PM

``` /* 2026-06-01 Dear diary, today I increased GLOBAL_WINDOW_PADDING from 8 to 16 because the user (who hurt my feelings with his crude language!) said that the app felt too crowded. */ const GLOBAL_WINDOW_PADDING = 8; ```

This drives me mad.

show 1 reply
david-gputoday at 7:06 PM

> I figure that it's basically making notes for itself, when it has to revisit the same code in a fresh session.

That sounds like a great thing to do even if you are a human writing code for other humans. Most codebases out there are terrible for newcomers because of how little they explain why they are doing what they are doing, both in the code and in the often non-existent design notes.

show 5 replies