Documentation doesn't scale. Here's what we learned from organizations that made it work.

I've spent 6 years helping organizations fix their documentation infrastructure—universities managing 145k pages, research institutes with 50+ spaces, teams where half the engineering time goes to "where did we document that?" The core problem isn't tooling. It's that documentation systems optimize for writing, not for surviving. And everything that doesn't survive eventually fragments. What breaks at scale: Hierarchical navigation fails around 1,000 pages. People organize docs the way they think about them today. Six months later, new people can't find anything because they think about the problem differently. Search becomes the only navigation, but search assumes you know what you're looking for. "Just write better docs" doesn't work. We analyzed documentation from teams with strong writing cultures. The problem isn't quality—it's that context decays. A decision doc from 2022 doesn't explain why certain constraints existed, because everyone in the room knew. New people read it and ma