State of Docs Podcast

GitBook

The State of Docs podcast brings you the conversations behind the research. Each year, the State of Docs report captures how the industry thinks about documentation — and this is where you hear it straight from the people who do the work. Interviews with technical writers, developer advocates, and developers who own docs, on the tools, workflows, and ideas shaping how we build and maintain documentation. Produced by GitBook.

Episodes

  1. May 20

    Why AI makes good docs more important, not less | State of Docs Podcast

    Good documentation doesn't just support your product — it is your product. In this episode of the State of Docs podcast, we talk with Shahed Nasser, Head of DX at Medusa, about how a developer-first open source platform thinks about documentation: building a custom docs platform from scratch, measuring what actually matters (hint: it's not page views), and why the best feedback about your docs often has nothing to do with your docs directly. We also get into AI — not just as a writing tool, but as a lens for finding knowledge gaps, simulating user journeys, and understanding why good documentation is more critical in the AI era, not less. This conversation took place a couple of months ago, and some of Shahed's workflows have evolved in that time. You can read more about that here: https://medusajs.com/blog/up-to-date-docs-with-agentic-automation/ Topics covered: technical writing workflow, docs as a product, measuring documentation impact, indirect feedback, AI in technical writing, search analytics, developer experience, open source documentation, and the future of the technical writer role. State of Docs is an annual research initiative tracking trends in technical writing, developer documentation, and knowledge management. This podcast shares some of the fuller conversations behind the report. Read the 2026 report: https://www.stateofdocs.com/2026 Learn more about Medusa: https://medusajs.com/ GitBook transforms documentation into an intelligent knowledge system that connects content, context, and AI — so your docs don’t just exist, they actively learn and get better over time. Learn more: ✨ Get started for free: https://app.gitbook.com/join 📚 Explore the docs: https://gitbook.com/docs 🌐 Visit GitBook: https://gitbook.com

    18 min

About

The State of Docs podcast brings you the conversations behind the research. Each year, the State of Docs report captures how the industry thinks about documentation — and this is where you hear it straight from the people who do the work. Interviews with technical writers, developer advocates, and developers who own docs, on the tools, workflows, and ideas shaping how we build and maintain documentation. Produced by GitBook.