Hacker News Reader

Hacker News

Comment by raincole | Hacker News Reader

Parent Full thread

raincole

> READMEs get to the front page and nobody seems to notice that it's written in grating Claudese

Or you know, it's just not that important whether the README is written by Claude or not.

Generally speaking people don't use a service/library for the author's ability to write excellent proses.

View on HN

> Generally speaking people don't use a service/library for the author's ability to write excellent proses.

I think this is incredibly wrong. I'd even go as far to say that a well presented README/website is the second most important factor, only behind network effect.

Presentation matters. Good documentation is evidence of a library that has been carefully thought through. Slop in the readme suggests slop in the code.

From my point of view, if I wanted an AI summary of a project I could generate one myself. An unlabeled AI readme is almost worse than nothing! I've generated AI readmes myself- they can be useful- but they aren't something to show off.

I'll read a badly-formatted readme written by a human with far more interest than a formulaic LLM summary of a project. But it seems like nobody even notices a readme is slop because it has nice Markdown, and my best guess as to why is that people have become habituated to this stuff.

I could vibe code the hell out of something but write a good README for it by hand, doesn't mean that something is actually good. But yes, A -> B != B -> A, as your last sentence says.

I've seen developers who genuinely like to write code, but never met one who likes to write documents. I know they exist somewhere, but I'd not judge someone's programming ability/willingness by their English writing ability/willingness.

I like to write documents. It helps me understand the code much better, as I'm forced to write down what's happening at each stage. Yes, code itself can be self documenting, but writing it in English can elucidate any hidden assumptions.

In this case the point is that they accompany the new flood of low-effort self-promoted shovelware vibecode projects.

Reply on news.ycombinator.com