Your next customer might integrate your product without ever visiting your documentation site. Their coding assistant will read it for them, choose an approach, and generate the code.
What happens when those instructions are outdated?
Mintlify’s 2026 State of Knowledge Report highlights the scale of this shift. In August, its sites recorded 257 million agent requests compared with 131 million human page loads. Yet only 7% of surveyed companies had made every knowledge surface readable by agents.
Making that knowledge accessible is essential. Keeping it accurate is an ongoing responsibility.
An outdated example served through Markdown or MCP still teaches the wrong approach. Making it easier to retrieve can make the mistake easier to repeat.
Consider that you shipped a change to your API authentication flow. Engineering ships it, and someone in DevRel updates the API reference. But the old approach remains in a quickstart, a support article, and an integration example.
Which version will a customer’s agent find?
At LI.FI, Netlify, Flutterwave, and Shardeum, I experienced how much documentation work depended on someone remembering those connections.
As products grow, that becomes harder to sustain.
I believe keeping product knowledge aligned should become a routine part of shipping software.
Every meaningful product change should prompt a review of the instructions it affects. Proposed updates should show the evidence behind them.
People should retain control over what gets published, especially when release timing, version support, or product intent requires judgment.
That is the thinking behind Thally.
Thally connects product repositories with the places teams explain their products. It identifies affected content and opens evidence-backed pull requests with proposed updates for the team to review.
Its documentation platform serves people and agents from the same source. The ongoing responsibility is keeping that source aligned with the product.
The question I want teams to ask after a release is simple:
Can someone following our published instructions still succeed?
That should be part of deciding whether the release is complete.
Top comments (0)