-91
do we need documentation in the age of AI?
(thelemmy.club)
you are viewing a single comment's thread
view the rest of the comments
view the rest of the comments
this post was submitted on 06 Oct 2026
-91 points (4.0% liked)
Programming
28751 readers
567 users here now
Welcome to the main community in programming.dev! Feel free to post anything relating to programming here!
Cross posting is strongly encouraged in the instance. If you feel your post or another person's post makes sense in another community cross post into it.
Hope you enjoy the instance!
Rules
Rules
- Follow the programming.dev instance rules
- Keep content related to programming in some way
- If you're posting long videos try to add in some form of tldr for those who don't want to watch videos
Wormhole
Follow the wormhole through a path of communities !webdev@programming.dev
founded 3 years ago
MODERATORS
A new account making extraordinary claims about AI and phrasing it as a question? Again?
As much as I can't stand AI fanatics, I think some of the anti-AI rhetoric (especially on Lemmy) can be just as dogmatic. OP didn't make any "extraordinary" claims. LLM agents have actually gotten remarkably good at many programming tasks, in particular tracking down bugs, and some of the things they're able to work out are genuinely impressive. At the end of the day it's another tool, but it can be a powerful one in the right context.
That's not to say anything about the environmental, social, and economic issues surrounding the tech and the industry. Obviously large companies are acting completely recklessly in all of those domains and I don't intend to justify that aspect. That said, I think it's disingenuous to frame OPs post as "making extraordinary claims" and it detracts from legitimate (and IMO mostly unimpeachable) arguments against AI.
Good point, I guess I rescind my argument.
This is not an extraordinary claim if you've used a good LLM in the last, say, year.
That's right, move those goalposts!
How did he move them?
"You're not using the latest model", "You're holding it wrong", etc...
It's the same shit, different day.
I'm consistently told LLM generated code is the best thing since sliced bread, and people keep handing me "proof", yet every time I open what they've handed me, I see a shit sandwich.
And as soon as I point that out, the goalposts are moved yet again, ad infinitum.
I think the effect you're seeing is that different people have different levels of "good enough", and also they work in different domains where AI became good enough at different times. E.g. for one-off web page design it's been good enough for a long time.
I never said this for earlier models, because they did suck for things like Rust and SystemVerilog. Now they don't.
I'd share some things I've vibe coded that work basically perfectly but they're linked to me real name, but you could have a look at the Mold linker which was recently vibe-ported to Rust.
In just the last two months, I've been handed the following web projects:
navigate(),goTo(), andchangeSlide()).I think the effect that I'm seeing is twofold:
You do understand that this is a rapidly developing technology right? That it's getting better weekly?
It's clear you have no idea what you're talking about. You can't just bury your head in the sand and tell yourself that LLMs are still just "advanced autocomplete" anymore.
This is literally the retort that moves the goalposts.
I made no claim that LLMs haven't changed, I make the claim that others are making claims that fall apart once examined.
The claims others make:
AI is amazing because now it can make this thing
Oh, the only reason doesn't hold up to scrutiny this one time is because of {insert goal post moving here}.
Argument 1 falls apart when looking inside the product (i.e. the shit sandwich, the slop grenade, etc...).
Argument 2 is circular, so I'm not going to waste time on it.
But just for the sake of argument, lets say there's some sudden release of a model tomorrow that runs one million times better than today's best model and everyone only uses that model from now on. Will I still be handed a shit sandwich?
Yes.
Why?
Because the fact that I'm handed a shit sandwich isn't influenced by how good the model is. It's based on the fact that English is a terrible language for logic.
We discovered this in the 60s and 70s. Computer programming was too hard in the 50s and only getting harder, so everyone got together and tried to make a programming language out of English, that way everyone could do it. That's literally how the Cobol language came to be. It was sold to everyone on the idea that anyone could create something with a fuzzy human readable language called English.
What did we learn? English is both a terrible programming language and a terrible specification language, Non-programmers (managers, general workers, etc...) fall prey to things like the xy problem, understanding gaps, intention gaps, etc... and so can't end up with a new good product by giving orders. The scars of that delusion are still felt in our banking system today. Every lesson learned by Non-programmers in the goal of getting a good program turns them lesson by lesson into programmers, and at that point you're just programming by hand anyway.
The same lessons were rediscovered in the 80s by people trying to program by spreadsheets and GUI-only app builders, the 2010s with the no code movement, it's currently being rediscovered in the 2020s with LLMs, and it'll be rediscovered again by a new generation in the 2040s once those with the experience and learned wisdom of last time retire out of the industry and the few remaining are outnumbered and dismissed as religious zealots.
Literally not moving the goalposts.
"things literally changing" is not "moving the goalposts".
Wut?
I responded in the other comment
It's really horrifying to see the cult propagate to lemmy, out of all places.
Go back to your closet with your blockchain and nft bros.
In what universe does "LLMs are good at some programming tasks now" make someone part of a pro-AI cult? This is the exact kind of black-and-white dogma you seem to be upset about.
Because LLMs are good at nothing other than maximizing the profit that "AI" companies make off the back of gullible sheep. That's their actual goal and the only thing they succeed at.
A slop machine is not good at any task other than producing slop. A broken clock showing the correct time twice per day doesn't mean that it is working, and we're not lacking studies that prove that no, LLMs are not a tool that can be used for anything useful or worth the costs.
This is just... objectively false. LLMs aren't miracle machines, but they're capable of performing certain tasks well and can be very useful in the right context.
I'm sure that you'll paint me as an AI shill incapable of independent thought for admitting this, but since starting a new job this year I've used LLMs most every day for software development tasks. It's excellent at catching mistakes and tracking down root causes that it would take me sometimes several times longer to find manually. The latter literally saves me days to weeks in the context of broad refactors, where there are hundreds or thousands of opportunities for me to make a typo or miss a case.
And no, I'm not blindly pushing "slop" into the product. I consider myself good at what I do and I'm capable of vetting every line of work that it does and recognizing when it's low-quality or misses the mark in some way.
Again, I'm not claiming they're miracle machines. They're subject to their own limitations and certainly aren't suited to every task. But to claim they can't be used for "anything useful" is completely disconnected from reality and, at its core, simply dogmatic.
"I believed in this product enough to use it everyday, and it led to me believing in this product" has quite the sect-like thought process resonating through it.
You believed that LLMs work, and you used them. And then, your experience as a "believer" is your reason to believe in them. There's no core to it, no critical thinking, just self-maintaining beliefs.
It's like religious people believing in miracles because they are religious, then saying that the miracles are the proof that their beliefs are true. That's just circular logic.
And with LLMs that have been shown to erode critical thinking and cause psychosis, that is even more meaningful.
You believe that you can vet every line of work, and you might believe that you do. You believe that the LLMs make things faster, you believe that the result isn't worthless, you believe that it is sometimes less error-prone than you (which is worrying in itself), etc. And that would be fine, if these beliefs didn't have the incredibly huge amount of very bad consequences that LLMs have.
This is so divorced from reality that it's frankly insulting. I "believe" in it because I've gotten good empirical results, not because I put blind faith into it. On the contrary, I'm extremely skeptical of anything it produces. And yes, I can vet every line of code. I'm skilled at what I do. I know how to do code review, whether it's written by a human or a machine. I can judge code and architectural quality or whether the root cause it landed on is accurate.
More often than not, the work done by the LLM is effectively the same as what I would have ended up with anyway, except instead of taking an hour or two to step through all the layers of the application to find the root cause I get an answer in about 5 or 10 minutes. How do I know it's not slop? Because I can read the code it references, understand the exact reason that the bug occurs, and fix it myself and watch the bug disappear.
I've been on the internet long enough that not a whole lot tends to get under my skin, but you asserting that I lack the ability for critical thought and just blindly trust the LLM output because I'm incompetent and don't know what I'm doing is beyond insulting. The irony is that you're the one applying your preconception to apparently anyone who disagrees with your dogmatic view. It's called post hoc rationalization: AI is obviously useless; therefore anyone claiming it has utility is doing so on blind faith and isn't applying critical thought because otherwise they couldn't possibly have come to that conclusion. I would suggest you reflect on the way that you've approached this dialogue, but the level of arrogance on display here tells me that you almost certainly won't.
Also, because I expect you to point and say that this is evidence that I'm some rabid AI zealot frothing at the mouth to defend the tech: I have no absolutely love for AI companies and I don't have a serious stake in the actual tech beyond it being a part of my workflow (societal/economic/environmental concerns notwithstanding). I don't care about it any more than I do the literal physical hammer in my toolbox. I just think you're a condescending asshole for telling me that actually, I only think it's hammering the nails in because I've put my faith in the hammer and I'm too oblivious to tell otherwise.
For what it's worth, I agree with you completely. LLMs are objectively a useful tool (and a fascinating technology - or rather, machine learning in general is), although I think the way it is pushed by "AI" companies is abhorrent in pretty much every way from environmental damage to intellectual property theft.
I think open weight models are a good compromise. I have tried out a few quantized models locally, and while they more often make mistakes than proprietary models, I can really see their potential. I hope in a few years we will have capable open models running on (high-end) consumer hardware. At least then I personally could use LLMs with good conscience.
And coding is such a great fit for LLMs since it is systematically verifiable and also often very repetitive. By following even the most basic principles of programming (TDD, design, code review, ...), you won't in practice care whether the code is written by hand or machine. If it lives up to your code standards and passes your tests, then it works! Thanks for your insight.
At some point you have to try it to see whether maybe it's you that is wrong.
(And when I say "it" I mean Astra/Opus 5.5. IMO earlier models did not quite live up to the hype.)
I am sorry but I couldn't resist AI. was avoiding it for very long time but it's actually good. specially for tedious task which I have to do. now I can focus on the fun part :)
More like couldn't resist obvious astroturfing
If that isn't the most whitewashing AI comment I've ever seen...
noone is saying AI is ethical.
So why are you using it? Why are you trying to whitewash something unethical?
Why do you drive a car?
Because I currently live in a country built around the car as the focal point for all urban planning, to the detriment of all of us. I also drive as little as possible, walk to work, etc. I'm not over the top enthusiastic about "how amazing it is to be forced to drive a car for literally everything" like you seem to be about AI.
It's one thing to be excited about AI from the getgo. It's another, seemingly incredibly disingenuous thing to say "I tried but just couldn't resist AI now look at how amazing it is there are zero downsides!". That right there is basically what you've said, and comes across solely as a statement to try to astroturf public opinion online.
I haven't said anything but... Do have you ever taken a flight instead of walking?
You must accept at some point that really fast and convenient wins, despite some environmental concerns (which are not even that bad really).
No, I really don't. I personally don't enjoy being gaslit and lied to, and that's about all LLMs are good for. They are an opinion aggregator, so they can regurgitate information, but don't have a mechanism for determining accuracy besides assuming that the most prevalent opinion is correct, which is absolutely the wrong way to go about it. LLMs are really just an inadequate substitute for critical thinking, and I refuse to ever kneecap myself by using them.
The days of constant hallucinations are over.
I get it - I was pretty much where you are a six months ago. AI just produces low quality slop. You have to watch it like a hawk because it will just bullshit some plausible but totally wrong solution. It will write tests that don't test anything, go round in circles making nonsense changes trying to fix things that are fundamentally wrong.
Yeah, those days are gone. The latest models (at least Astra 6 or Opus 5.5) are actually competent.
I have no skin in the game in convincing you but you're pretty much in the "the iPhone is only popular because of Apple fanboys" stage of denial. I guess the only real cost for you is wasted time and being late to the party, but... that's probably still bad.
And no I'm not super happy about this. I mean it's great that I can now easily vibe code the tools I always wanted - and the vibe coding actually works, unlike 6 months ago.
But it also doesn't bode well for me having a job and I like having a job. 😔
But I'm not going to stick my head in the sand and pretend that AI is still shit just because it would be great for me if that were the case.