July 13, 2026
|
AI
AI

Documentation is knowledge infrastructure

In April 2025, AI code editor Cursor began logging developers out each time they moved between machines. Sam, an AI support bot, explained the lockouts were intentional: a new policy limited each subscription to a single device. But no such policy existed; Sam invented it. The false explanation spread across Hacker News and Reddit before Cursor could correct it, prompting public complaints, with users posting that they had canceled.

Sam functioned exactly as AI support layers are designed to, filling a retrieval gap with a confident confabulation. The irony was hard to miss: a company promising AI reliability to developers, undermined by documentation that was never written for a machine to read.

In a way, Cursor was fortunate that the failure was loud. The post went viral and forced a correction within hours. An undramatic version of the same flaw, one that never trends, just gradually sends dissatisfied users away, without a thread to trace it back to.

The knowledge layer supports everything

AI has moved documentation upstream. Retrieval systems, copilots, and support agents rely on documentation directly to connect users and prospects with what they need. For most of software's history, a human stood between the page and the reader, carrying context the page lacked and filling its omissions. Now, without a person in the loop, what the documentation says is what the user gets.

When a machine reads your documentation and acts on it without a human intermediary, your documentation is infrastructure. It bears a load, and everything downstream depends on its integrity.

When knowledge infrastructure gives way, its failure cascades. Take an onboarding guide that lists a deprecated installation step. Read by one person, it's a minor annoyance, but fed to an agent setting up new developers at scale, it can break every environment it touches.

Black abstract texture suggesting AI confabulations, chatbot noise, and bad AI agent output

The industry is picking up on the pattern. Gartner has projected that 60 percent of AI projects unsupported by AI-ready data will be abandoned through 2026, and the consensus across this year's enterprise reporting points away from model quality as the binding constraint and toward a different question: can the knowledge underneath the model be trusted?

Documentation has authors; infrastructure has owners

"Documentation," as a label, sounds like a reference, obscuring its role as an operational dependency. Real infrastructure has an owner, monitoring, and an on-call engineer who is paged when it breaks. Until now, documentation has lacked that kind of stewardship, more commonly scoped as a deliverable: complete once it ships and unowned thereafter.

Unowned documentation is a latent liability until the moment it publicly fails. In 2024, a Canadian tribunal held Air Canada liable after its chatbot incorrectly told a grieving customer he could claim a bereavement fare for his flight, contrary to the airline's policy. When Air Canada argued he should have checked the correct page himself, the tribunal ruled that customers are not responsible for reconciling one part of a company's site with another. The failure lived in the knowledge infrastructure until it openly presented itself.

A knowledge layer that systems rely on needs someone accountable for keeping it current, the way every other piece of production infrastructure does. Yet many organizations lack this person, and the org chart offers no obvious place to put one. As teams streamline and ship faster, the absence is easy to miss because a neglected knowledge layer shows no initial symptoms until something reads from it and gets it wrong. Without a steward, that failure erupts, as it did for Cursor, or leaks out slowly and unnoticed.

Rail lines and overhead wires suggesting documentation infrastructure, knowledge routes, and AI-ready documentation

Your documentation already speaks for you

You already own what your documentation says, whether or not anyone has been made responsible for it. The moment a system acts on your documentation, that documentation speaks for the company, for better or worse. The stories above chronicle an industry learning, case by case, about what incomplete, outdated, or badly structured documentation can cost when AI retrieves it.

Treat your documentation as the knowledge infrastructure it has become. It carries every team that reads from it, and its failures reach just as far. Load-bearing infrastructure must be owned and maintained; otherwise, it can fail your users first and your business next. Talk to us about your knowledge layer.

Get more from us

Join our email list to receive insights into documentation and technical marketing.

Thank you for subscribing to our newsletter!
Oops! Something went wrong while submitting the form.

Request a consultation

Tell us about your product and current docs so a documentation specialist can scope effort, timelines, and next steps.

Or speak with an agent now
tech writer 1tech writer 2tech writer 3
1
2

Tell us your documentation challenges

The details you provide will allow us to determine an estimate.

Max file size 10MB.
Uploading...
fileuploaded.jpg
Upload failed. Max size for files is 10 MB.
1
2

Contact details

Please provide your best contact information.

We respect your privacy. We’ll use your information to send relevant content and services. You can unsubscribe anytime. See our Privacy Policy for more details.

Previous step
Next step

Thank you! Your submission has been received.

One of our Customer Success Managers will get in contact with you immediately about next steps on getting your project started!

Oops! Something went wrong. Please Go back and make sure all the necessary info is filled in.
Made with ❤️ and 🌮 in Austin, Texas and serving worldwide