Docs are like travel guides. When the underlying reality changes, they need to be rewritten. But most organizations barely make the effort for one good guide, l

Docs are like travel guides. When the underlying reality changes, they need to be rewritten. But most organizations barely make the effort for one good guide, let alone a guide that is rewritten as the code changes. So what happens is, they write a guide, go back to their business, and when a traveler says "hotel X doesn't exist anymore", they delete reference to hotel X. Not a great strategy! What's worse, it's a travel guide written by a real-estate developer. That is, the very people writing the guides are making their own guides outdated.