I love that now that computers are starting to pay attention to documentation, all of a sudden content design, documentation pruning, discoverability and indexing become things companies care about.
Nobody ever gave this much thought to their API documentation until they started turning it into MCP tools.
I've noticed this recently. Libraries that normally wouldn't have much documentation now has quite a long README.
I thought it was a blessing until I start reading them and realize that many of them are clearly generated by AI... The information is not wrong, but most of the time it's too long and a pain to read. Human written documentation are typically better at picking and choosing relevant information rather than dumping every single little thing
All of the boosters of the Semantic Web were just a little too early to the market...