Real Alpha
Watch mode

Full episode · 21 min

AI Agents Are Replacing Human Readers | Han Wang

Han Wang says documentation must serve both people and AI agents, even as agents take on more writing and maintenance.

MTS · Sophia Dew with Han Wang

The best minutes

  1. 3:02Agent traffic does not make human-friendly docs obsolete4 min
  2. 7:02Agents automate code but still face business decisions6 min
  3. 13:15Good docs need structure, even as agents take over writing6 min

Skip the opening traffic figures and show introduction, plus the closing prediction about self-updating docs.

Summary · 2 min read

Han Wang is a co-founder of Mintlify; the host introduces him as the company’s CEO. Wang says Mintlify serves over 20,000 companies and more than 100 million people visit its sites each month.

Wang says agent traffic across Mintlify-powered sites rose from about 15% to 80%, making agents the predominant audience for documentation. He argues companies should still design for people, since humans continue to use docs and agents act on people’s requests and draw on human preferences reflected online. He expects coding agents to automate implementation while people retain input on consequential business and vendor choices. For documentation, he sees AI taking on more writing and maintenance as products change faster, while people steer the work and explain product intent.

Minute by minute

  1. 0:00

    Agent traffic became dominant. Wang says agent traffic across Mintlify-powered sites rose from about 15% to 80% over the year. He says the shift changed who companies need to design for, with agents now the predominant audience.

  2. 3:12

    Human-facing docs still matter. Wang says rising agent traffic does not mean companies should stop designing for people: human visits have also grown, as people continue to onboard and browse. He argues that strong human-facing docs remain valuable, with agent experiences layered on top.

  3. 7:02

    People retain high-level decisions. Wang says coding agents can automate implementation details, such as how to write code, but people still face high-level choices with business consequences. He expects agents to ask for input on decisions such as choosing a database, especially when financial commitments or business outcomes are involved.

  4. 8:50

    Human preferences shape agent choices. Wang says agents draw on websites, forums, Reddit and blog posts that reflect what people use and like, so companies still need to win people’s attention. He says platforms such as Lovable may abstract vendor choices, but users may still need to opt in to paying for providers such as Vercel.

  5. 12:52

    Better structure beats data dumps. Wang advises teams to write better docs rather than rely on protocols to compensate for weak content. He says agents need context and clear sections to find the right information; large, unstructured dumps perform worse, and content still needs to be accurate and current.

  6. 15:56

    AI writes; humans steer. Wang says agents are becoming primary writers and maintainers because product changes are arriving too quickly for people to keep documentation current. He expects technical writers and developer-relations teams to shift toward steering the work, explaining product intent and use cases, and bringing in customer insight.

  7. 18:58

    Docs will update themselves. Wang expects documentation to become more autonomous over the next year. He says Mintlify is developing self-updating docs that can ask clarifying questions while people continue to guide them.

Published Oct 16, 2026.

More interviews