EPISODE · May 20, 2026 · 18 MIN
Why AI makes good docs more important, not less | State of Docs Podcast
from State of Docs Podcast · host GitBook
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/2026Learn 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
What this episode covers
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/2026Learn 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
NOW PLAYING
Why AI makes good docs more important, not less | State of Docs Podcast
No transcript for this episode yet
Similar Episodes
Mar 26, 2026 ·1m
Mar 19, 2026 ·34m
Feb 18, 2026 ·11m
Feb 11, 2026 ·45m