In partnership with
AI Agents Are Reading Your Docs. Are You Ready?
Last month, 48% of visitors to documentation sites across Mintlify were AI agents—not humans.
Claude Code, Cursor, and other coding agents are becoming the actual customers reading your docs. And they read everything.
This changes what good documentation means. Humans skim and forgive gaps. Agents methodically check every endpoint, read every guide, and compare you against alternatives with zero fatigue.
Your docs aren't just helping users anymore—they're your product's first interview with the machines deciding whether to recommend you.
That means:
→ Clear schema markup so agents can parse your content
→ Real benchmarks, not marketing fluff
→ Open endpoints agents can actually test
→ Honest comparisons that emphasize strengths without hype
In the agentic world, documentation becomes 10x more important. Companies that make their products machine-understandable will win distribution through AI.
Chapter 4 is a game-changer. Zig dives deep into the art of asking questions – and I'm not talking about boring stuff like "What's your budget?" I'm talking about questions that actually open doors.
Here's what blew my mind: the person asking the questions is the one in control of the conversation. Not the person talking the most. When you ask the right questions, buyers tell you exactly how to sell to them. They literally hand you the roadmap.
Zig explains that most salespeople talk way too much. They're so excited about their product that they just dump information on people. But smart salespeople ask questions, then shut up and listen. That's when you learn what really matters to the buyer – and what doesn't.
He also gets into something called "involvement questions" – questions that get buyers imagining themselves already using your product. That's when the magic happens.
Key Takeaways:
The person asking questions controls where the conversation goes
Listen twice as much as you talk – there's a reason you have two ears
Open-ended questions get you real information, yes/no questions don't
Good questions make buyers sell themselves on your product
"Why" and "how" questions dig deeper than surface-level stuff
Silent pauses after questions are powerful – don't fill them
Your Action Plan:
First, write out ten questions you should be asking every prospect. Focus on their problems, not your product. Things like "What's not working right now?" or "How is that affecting your team?"
Second, practice staying quiet after you ask a question. Count to five in your head if you have to. Let them think and respond fully.
Third, listen for emotional words. When someone says they're "frustrated" or "overwhelmed" or "excited," that's gold. Dig into those feelings with follow-up questions.
The big takeaway? Your mouth should be closed way more than it's open. Every question you ask should either uncover a problem, show you care, or help them picture life after they buy. Stop pitching and start investigating.