Your docs lie.
And you lie to yourself, that they are accurate.
[this may be about your company!]
Almost every dev team I work with has Confluence. Most of them add new docs to it, sometimes.
Here’s uncomfortable question I ask :)
“When did someone delete a page from your docs?”
Usually: silence. Sometimes laughter. Occasionally: “we just moved to new Conflu space”
---
For years, stale documentation was annoying but manageable. Developers built up an intuition, which pages to trust, which ones to skip, which section was written by someone who left two years ago.
Aaaaaand... that intuition doesn’t transfer to an AI agent.
When you point your agent at Confluence, it reads the 2022 deployment guide with the same confidence it reads last week’s ADR. It doesn’t know about the migration. It doesn’t know the integration described was deprecated eight months ago.
Stale docs used to be noise. Now they’re misinformation, at the speed of an agent.
---
Teams getting the most out of AI-assisted work take this matter seriously.
They’re the ones where the docs reflect the system as it actually is today, not as it was planned, not as it existed before the last rewrite.
A short, accurate doc beats a long, stale one. Every time.
---
So: when did your team last remove something from your docs?
If you have to think about it for more than five seconds... that’s your answer.