[FranksTV]

"But the code is self-documenting!"

[IntelMiner]

No matter how good your documentation or comments are, that doesn't mean whoever is left holding the bag will understand it. Or at least not in the amount of time it would take to keep it from exploding

I understand the abstracted theory of how a nuclear power plant works (uranium heats water -> makes steam -> drives turbines etc) but if you sat me down at the control console and asked me to restart a reactor? Yeah I'd have no idea where to even begin. Even if I had a manual as thick as a fridge to (slowly) flick through

[mastazi]

I have the impression that the comment you are replying to was sarcastic. Of course you're right that experience can't be replaced with documentation. The role of documentation IMHO is making it easier for people to gain experience by smoothing out the process -> it aids the process of gaining experience, does not replace it

[fires10]

I was a reactor operator. I can't do it now. It takes continuous use to maintain knowledge and skills that narrow.

[2muchcoffeeman]

AKA domain knowledge

[ithkuil]

Indeed, if a dumb computer can understand the code and execute it flawlessly then so can you! /s

[_the_inflator]

Of course. The machines get it. And do exactly as commanded. ;)

[jjgreen]

They used to, now they mutter amongst themselves, casting occasional contemptuous glances at you and me.