Behind the Docs

Heretto

Welcome to Behind the Docs — the podcast that spotlights the people who make technical content come to life. Whether you're a seasoned tech writer, content strategist, or just curious about the brains behind the docs you rely on every day, this show is for you. Each episode features real conversations with the folks who build help sites, craft user guides, and keep the content engine running behind the scenes. No jargon, just smart, engaging stories about the work, the wins, and the humans making it happen.

  1. MAR 31

    What Great Documentation Actually Means in Cybersecurity - Jeff Cross at Arctic Wolf

    Jeff Cross didn't plan to become a technical writer. He started a computer science degree, dropped out, spent a year trying to make it as a fiction writer, went back for a philosophy degree, considered academia, and then — almost by accident — realized that technical writing was the thing that made all of it make sense. Now Senior Manager of Technical Writing at Arctic Wolf, Jeff has spent years doing some of the most complex content work in the industry: documenting third-party security integrations he has no direct access to, managing a full DITA migration while keeping up with release cycles, and pulling off a content carve-out from a corporate acquisition with translated content in three languages and a hard deadline. In this episode, Jeff and Patrick talk about what it really means to do great documentation work, and why the hardest parts rarely show up in a job description. They cover: - Why the security space takes documentation seriously in ways other industries don't - What happened when a product rename turned "a" into "an" across thousands of content files - How AI helped a small team execute a DITA-to-DITA migration without outside help - The checkbox doc that nobody wanted to write — and that way more people read than expected - Why technical writing is less like writing and more like investigative journalism Plus: Patrick discovers mid-conversation that Jeff was the person who fixed the BlackBerry email signature problem that drove him personally crazy for a year.

    41 min
  2. MAR 24

    Designing Documentation for Agents, Not Just Users - Dachary Carey of MongoDB and Agent-Friendly Docs Expert

    In this episode of Behind the Docs, Ren sits down with Dachary Carey of MongoDB to explore a rapidly emerging challenge: AI agents can’t reliably read your documentation and most teams don’t realize it. Dachary shares how a deep dive into agent workflows (sparked by tools like Claude Code) uncovered critical gaps in how documentation is structured, delivered, and consumed by machines. From truncated pages and hidden content to the unexpected importance of formats like llms.txt, this conversation reveals why even well-written docs can become effectively invisible to AI systems. They also dig into: how agents actually interact with documentation (and where they fail)why technical writers are becoming essential to AI successand the growing gap between companies investing in docs and those cutting them entirely If you’re thinking about AI, content strategy, or the future of technical writing, this episode is a must-listen. Important Links: Dachary's LinkedIn: https://www.linkedin.com/in/dachary/Dachary's website: https://dacharycarey.com/The Agent-Friendly Documentation Spec: https://agentdocsspec.com/The GitHub repo for anyone who wants to contribute or leave feedback: https://github.com/agent-ecosystem/agent-docs-specThe npm tool (afdocs - for Agent-Friendly docs) that documentation teams can run to see how agent-friendly their documentation is: https://www.npmjs.com/package/afdocsThe GitHub repo for that tool for anyone who finds an issue or has a suggestion or request: https://github.com/agent-ecosystem/afdocs

    36 min
  3. MAR 10

    AI Isn't the Main Character with Sara Feldman of the Consortium for Service Innovation

    In this episode of Behind the Docs, Ren welcomes back Sara Feldman, Director of Member Engagement at the Consortium for Service Innovation and longtime advocate for knowledge-driven customer experience. Sara began her career as a technical writer, spending a decade embedded with support teams before diving deeper into knowledge management through Knowledge-Centered Service (KCS). That journey eventually led her to the Consortium, where she now works with member companies around the world to explore new approaches to service innovation and knowledge management. Together, Ren and Sara discuss: How KCS helps organizations capture and reuse knowledge in real timeWhy demand-driven knowledge practices produce better documentation and supportThe rise of intelligent swarming and how it could reshape how work gets routed across teamsWhy many organizations are struggling to operationalize AI despite the hypeThe importance of structured, trusted knowledge in an AI-driven worldWhy reducing customer friction matters more than simply improving efficiency Sara also shares insights from working directly with industry leaders across customer support, customer success, and service operations—and why the future of AI success will depend heavily on strong knowledge foundations. If you’re curious about the intersection of documentation, knowledge management, and customer experience, this episode offers a thoughtful look at where the industry is heading next.

    42 min
  4. MAR 3

    Clarity is the Hill with Melanie Denise Davis of Dragonfly Diva Docs

    In this episode of Behind the Docs, Ren sits down with Melanie Denise Davis — journalist-turned-technical-communication leader, AI Wrangler, and founder of Dragonfly Diva Docs. Melanie’s career spans the evolution of modern technology itself: from punch cards and mainframes to structured content and AI. She shares what it was like entering tech before technical writing was even a defined profession, helping shape the field alongside early STC efforts, and now contributing to the ISO standard defining technical communication management. Together, they explore: ✨ Why technical communicators are far more than “glorified typesetters” ✨ The difference between writing words and engineering information ✨ Why structured content is essential for AI success ✨ How technical writers are the natural curators of generative AI ✨ The importance of allies, mentorship, and resilience as a woman of color in tech ✨ Why clarity — not grammar — is the true hill to die on Melanie also discusses her role with The Content Wrangler, her work in the upcoming Women in Technology anthology, and why this may finally be the moment technical communicators step fully into their power. If you care about clarity, collaboration, and the future of AI-ready content, this episode is packed with wisdom you won’t want to miss. Helpful Links Melanie on LinkedinDragonfly Diva DocsWomen in Technical Communication

    39 min

About

Welcome to Behind the Docs — the podcast that spotlights the people who make technical content come to life. Whether you're a seasoned tech writer, content strategist, or just curious about the brains behind the docs you rely on every day, this show is for you. Each episode features real conversations with the folks who build help sites, craft user guides, and keep the content engine running behind the scenes. No jargon, just smart, engaging stories about the work, the wins, and the humans making it happen.

You Might Also Like