Remix.run Logo
benrbray 7 hours ago

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

raincole 2 hours ago | parent | next [-]

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.

satvikpendem 3 hours ago | parent | prev | next [-]

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.

roywiggins 6 hours ago | parent | prev [-]

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.