But for real, I think you misunderstand the point of documentation. Even if something were truly, literally flawless, having documentation would still be a net gain. It isn’t only to fix something when it goes wrong, but explains how things are working. If the only way for something to be literally flawless in your world view is for it to be so self explanatory that an idiot seeing it for the first time still understands it perfectly, nothing in computing can be flawless in that way.
The pedantry on this point is so unhelpful as to be actively harmful to the rest of the discussion.
Damnit, you’re right!
But for real, I think you misunderstand the point of documentation. Even if something were truly, literally flawless, having documentation would still be a net gain. It isn’t only to fix something when it goes wrong, but explains how things are working. If the only way for something to be literally flawless in your world view is for it to be so self explanatory that an idiot seeing it for the first time still understands it perfectly, nothing in computing can be flawless in that way.
The pedantry on this point is so unhelpful as to be actively harmful to the rest of the discussion.