I know there is a lot of consternation around, "why did it take until AI for developers / platforms / vendors to care about documentation?" It is simply because the ROI is much higher now because these tools enable a much less lossy compounding of knowledge.
Writing better documentation for humans improves outcomes only those humans who care about it, but doing so for agents improves outcomes for 100% of users of agents whether they care or not.