cd /news/ai-agents/the-future-of-product-documentation · home topics ai-agents article
[ARTICLE · art-138581] src=dev.to ↗ pub= topic=ai-agents verified=true sentiment=· neutral

The Future of Product Documentation

A developer who worked at LI.FI, Netlify, Flutterwave, and Shardeum has launched Thally, a tool that connects product repositories to documentation surfaces, identifies content affected by code changes, and opens evidence-backed pull requests for teams to review. The project responds to Mintlify's 2026 State of Knowledge Report, which found that its sites logged 257 million agent requests in August versus 131 million human page loads, while only 7% of surveyed companies had made every knowledge surface readable by agents. The developer argues that keeping documentation accurate for AI coding assistants should become a routine part of shipping software.

by read2 min views1 publishedSep 23, 2026

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.

── more in #ai-agents 4 stories · sorted by recency
── more on @thally 3 stories trending now
sponsored brought to you by zahid.host 4,200+ EU-deployed projects
reading about agents? ship yours in a single git push.

Run your AI side-project on zahid.host

EU-based hosting, git-push deploys, automatic HTTPS, no cold starts. Free tier with a custom domain — perfect for shipping the agent you just read about.

$git push zahid main
Live at https://your-agent.zahid.host
Get free account → Pricing
from €0/mo · no card required
LIVE [news/the-future-of-produc…] indexed:0 read:2min 2026-09-23 ·