news.ycombinator.com

Untitled

adastra22 · 0 points · 0 comments · Hôm qua

I would throw the entire docs out and write it from scratch in your own words. I get that we live in an era where the machine writes most/all of the code, and I can accept that. What I need, to even consider using and extending this project, is some understanding of what part of the design is yours and what part is accident by Claude. I can't get that from reading Claudese.

Comments

5 preview comments · loading full thread
assimpleaspossiHôm qua

>>I get that we live in an era where the machine writes most/all of the code Only on the Internet is this true, not in real life. I cannot and do not trust any of these things to do a proper job because they have not in any situation succeeded in any job I've given them. And no company I deal with claims otherwise

dirktHôm qua

Eh, I think the tutorial is pretty readable? It's concise enough. With the tutorial, the summary also makes more sense. I have not read the other parts yet, but so far I like what I see. All is in pretty good taste, and I like what I've seen so far. I do not care if the author himself came up with the idea, or if AI came up with it and the author approved. I do not understand why you "have to" know this to make use of it. You can judge ideas independently of where they came from (and you should).

shmageggyHôm qua

100% Couldn’t make it more than a few sentences in before the bile started to build up in the back of my throat and I had to back out. It’s shocking to me that people knowingly post unedited Claude-slop drivel and are seemingly unashamed about it. In 2026, it seems the main role of technical humans should be to act as a barrier between our agents’ output and other humans.

WillAdamsHôm qua

The version of the documentation which I would very much like to see would be a Literate Programming version where all the code is explained from the ground up. Apparently, this can actually assist the LLM: https://silly.business/blog/we-should-revisit-literate-progr... as discussed here previously: https://news.ycombinator.com/item?id=47300747

polski-gHôm qua

Once a week, I tell Antigravity (3.8-flash) to rewrite every code comment and documentation that was changed in the past week. Neither GPT nor Claude can write like a human.