Dawg get the fuck out of software and go get an MBA like you should’ve in the first place.

Money-chasers should stick to their own fucking lane. You’re fucking this up for those of us that actually like tech work. Fuck me.

I was in an incident at work for software written by AI, with docs written by AI. It lasted DAYs and AI nor the slopper who slopped it could get it working. The “docs” were horribly wrong. I finally fixed it and now im writing docs for it without AI.

AI is not “smart” or deterministic.

There’s a lot of people here that clearly haven’t ever tried what you’re describing op (or maybe tried recent AI at all).

I have. I think it’s a totally valid question. Sometimes when I’m getting AI to do stuff it reads the docs and then tries stuff anyway and finds the docs are wrong.

I also often use AI to generate docs for undocumented things.

But I think it does still make sense to have docs for a few reasons:

1. They show the intent explicitly, rather than having it inferred. Same reason anything explicit is better than implicit, e.g. static types.
2. It spends fewer tokens to read docs than to constantly reverse engineer software.
3. It’s also quicker.
4. Sometimes you do still want to understand the thing…

bruh

Every time you use AI a puppy dies.

made me realize do we still need documentation of how a software work when a AI can easily explain it?

I’ll respond for the sake of argument, but to put it bluntly: there are no stupid questions, just questions phrased stupidly.

Documentation comes in many formats. There’s prose documentation split into articles and chapters, there’s video documentation, inline documentation for code, tutorials, training, and so on. Most things are documented several ways. This is because people learn things differently from each other.

To remove documentation entirely and rely on only LLMs to document removes all of the ways that people might learn and narrows it down to only one form of documentation. Even if we ignore how fallible LLMs can be, having documentation in only a single format limits learning only to those who learn effectively through that format.

In other words, relying only on LLMs for documentation discards all of the millenia of teaching strategies learned throughout the course of human history and puts it in the hands of a stochastic magic box that is incapable of recreating those strategies.

A new account making extraordinary claims about AI and phrasing it as a question? Again?

Yes cause understanding software is important even if you use AI.

And even if you want to go full vibe code and never look at anything yourself the AI does need documentation, compare the performance of an agent on a large project with and without an AGENTS.md, the difference is massive. Without the agent usually does figure it out, but it spends a ton of tokens searching.

Move along. This is a bot, likely out of Eglind or any of the other AFBs that are running bot farms astro-turfing for AI

You’re doomed. But do it anyway, more work for me later.

@bruh Of course, we still need documentation. What happens when you run out of credits for your AI assistant, or, worse yet (as I believe is coming personally), what happens when the bubble bursts, the price skyrockets, and none of us can afford it anymore?

All of that being said I’m going to have to try that on my own system. I’m having some issues with Wiki.js