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

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

Episode metadata supplied by the publisher feed · Published May 20, 2026

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

PodParley-generated summary based on available episode metadata and transcript content.

NOW PLAYING

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

0:00 18:20

No transcript for this episode yet

We transcribe on demand. Request one and we'll notify you when it's ready — usually under 10 minutes.

Ask A Spaceman Archives - 365 Days of Astronomy Ask A Spaceman Archives - 365 Days of Astronomy Podcasting Astronomy Every Day of the Year Eat to Live Jenna Fuhrman, Dr. Fuhrman Our health is our most precious gift and smart nutrition can change your life. Each month, join Dr. Fuhrman and his daughter, Jenna Fuhrman as they discuss important topics in the world of nutrition. Eat to Live will change the way you eat and think about food. French Your Way Jessica: Native French teacher founder of French Your Way Boost your French listening skills and test your comprehension with this one of a kind series of podcasts. Get the chance to listen to a real conversation between native speakers talking at normal speed AND customise your learning experience through carefully designed sets of questions (2 levels of difficulty) available for download at www.frenchvoicespodcast.com. All interviews also come with the transcript. French teacher Jessica interviews native speakers of French from around the world who share a bit of their life and passion. Where else would you meet in one same place a French yoga teacher based in Melbourne, a soap manufacturer from Provence, or a couple cycling around the world? That Hoarder: Overcome Compulsive Hoarding That Hoarder Hoarding disorder is stigmatised and people who hoard feel vast amounts of shame. This podcast began life as an audio diary, an anonymous outlet for somebody with this weird condition. That Hoarder speaks about her experiences living with compulsive hoarding, she interviews therapists, academics, researchers, children of hoarders, professional organisers and influencers, and she shares insight and tips for others with the problem. Listened to by people who hoard as well as those who love them and those who work with them, Overcome Compulsive Hoarding with That Hoarder aims to shatter the stigma, share the truth and speak openly and honestly to improve lives.

Frequently Asked Questions

How long is this episode of State of Docs Podcast?

This episode is 18 minutes long.

When was this State of Docs Podcast episode published?

This episode was published on May 20, 2026.

What is this episode about?

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:...

Can I download this State of Docs Podcast episode?

Yes, you can download this episode by clicking the download button on the episode player, or subscribe to the podcast in your preferred podcast app for automatic downloads.
URL copied to clipboard!