[dandrew5]

True, good documentation is a rare thing. If the hype does hold and the current trajectory of things stays somewhat the same, I think it will be inevitable that the definition of "good documentation" will change. If it were geared towards a machine audience, I wonder if it would increase reliability and reduce hallucination.

I could imagine a hybrid approach as well where there are two versions: one for humans and one for machines. If respected, the crawlers could look for a special <meta> tag of sorts that points them to the machine version.