I don't think the purpose of documentation is to explain the what, but the why.
As an example, in a device driver project, we need to send no-ops to the hardware to slow it down, in order to alleviate a hardware overheating issue.
Can AI or even human realize the reason by looking at no-ops?