deleted
reply> READMEs get to the front page and nobody seems to notice that it's written in grating Claudese
replyOr 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.
> Generally speaking people don't use a service/library for the author's ability to write excellent proses.
replyI 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.
replyI'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.
replyI 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.
replyFrom 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.
replyI'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.
In this case the point is that they accompany the new flood of low-effort self-promoted shovelware vibecode projects.
reply