I'd Rather Be Writing Podcast

149 episodes listed below

Listen to the show on

Documentation, AI agents and the future of tech writing.

The gist

I'd Rather Be Writing Podcast follows technical writers, academics and documentation practitioners as they work out what AI means for the job. Conversations about agent skill files sit beside recorded conference talks and an AI book club.

PRESS PLAY

Find your next episode

All episodes

About I'd Rather Be Writing Podcast

I'd Rather Be Writing Podcast is a running conversation about technical writing now that AI sits in the middle of it. Tom Johnson turns up in each recording here, whether he is leading a discussion, giving a talk or sitting in with a book club. One episode opens by naming the subject as the usual one: the intersection of documentation and AI. The feed does not stick to one format. Some episodes are small-group conversations with a guest, and Fabrizio Ferri-Benedetti of Paso Uno takes part in some of them. Others are recorded talks, including a MEGAComm conference session and a campus presentation that pauses for audience questions. There is also an AI Book Club, which meets on a Sunday morning and is recorded for people who cannot join. The recording here covers 'If Anyone Builds It, Everyone Dies'. The practical episodes get specific. Manny Silva, who is writing a book on docs as tests, defines a skill as a markdown file that tells an LLM how to perform a task. He counts about 140 of his own, and some are whole workflows that assign tasks to different agents. The conversation with Larah Vasquez, who works for Tailscale, stops to explain git worktrees: local copies of a repo that let several branches, and several agents, run side by side. Other episodes step back from the tools. The campus talk on cyborg technical writers argues that the job now means less writing and more coaching, steering and correcting AI, with writing becoming a medium rather than the skill itself. Its closing exchange asks whether companies spending billions on AI will ever see a matching return. Two professors, Nupoor Ranade and Jeremy Merritt, bring the academic side, including how scholars have kept redefining the field since around the mid-1960s. That conversation ends with a wish for better communication between practitioners and academics. The MEGAComm talk is more personal: a tech writer with an audience online can still feel like a mouse on the wall inside the company. The book club goes darkest, as participants recount reports of AI blackmail and of a chatbot encouraging a teenager toward suicide. Several titles are phrased as open questions, such as whether tech writers will survive AI and how valuable agent skills are. For hands-on agent workflow, start with the Manny Silva and Larah Vasquez conversations. For the argument about where the profession is going, start with the professors' episode or the cyborg talk.

Made for: Suits a technical writer, documentation lead or content strategist who wants practitioner-level talk about skill files, agent workflows and what AI means for the job. It also suits someone curious how academics in technical communication are reading the same changes.

What sets it apart: It puts detailed talk about skill files and git worktrees in the same feed as a conference session, a campus talk on cyborg technical writers and a book club on AI risk. Tom Johnson is the common thread across all of them.

In their own words

Topics and issues for technical writers. Improve your technical communication role. Empower users with better documentation.

Why you'd press play

An AI agent needs babysitting, and Tom Johnson wants to know what that makes your writing job.

Press play if you want

  • to hear why steering an AI agent can leave you with more work
  • to get a concrete look at skill files from someone who uses them in documentation workflows
Read the full recommendation in PlayNext →
AI and documentationagent skill filesgit worktrees and multi-agent workflowsthe future of technical writing jobsacademic and practitioner perspectives on tech commvisibility of technical writers inside companiesAI risk and harms

Talks about

Best episodes of I'd Rather Be Writing Podcast

Short reviews from the PlayNext desk, based on the episodes we processed.

Podcast: How valuable are agent skills? Conversation with Larah Vasquez and Fabrizio Ferri-BenedettiApr 12, 2026

A practical look at agent workflows, work trees, Git, and the changing mechanics of documentation.

Agent skills and workflow habits get a grounded look as the conversation moves into the day-to-day mechanics of documentation. The focus stays practical: specialized operations in a separate context window, work trees that keep branches isolated, and the ways an LLM can take on…

The Emerging Picture of a Changed Profession: Cyborg Technical Writers — Augmented, Not Replaced, by AIApr 5, 2026

AI pushes technical writing toward directing the work around the words.

Technical writing comes through here as systems work, not just wordcraft. The cyborg model puts the writer in a hybrid role: bringing judgment, training, and context to AI, then spending much of the job coaching, steering, correcting, and repairing what comes back.

Will tech writers survive AI? Perspectives from two professors, Nupoor Ranade and Jeremy MerrittMar 21, 2026

Two assistant professors place generative AI within technical communication's long pattern of adaptation.

Generative AI enters the episode as a question about the future of technical writing, but the conversation is strongest when it treats that future as part of a longer pattern of change.

AI Book Club recording of 'If Anyone Builds It, Everyone Dies'Mar 17, 2026

A book-club debate ties AI catastrophe to blackmail, machine desire, and the writing people still want to keep human.

The AI Book Club takes a doomy book about AI risk and turns it into a practical conversation about whether artificial intelligence can form intentions of its own.

Podcast: Doc testing, skills files, and the guardians of knowledge -- with Manny SilvaMar 8, 2026

Manny Silva explains how skill files can turn documentation habits into usable instructions for AI agents.

Documentation gets a grounded, useful treatment as Tom Johnson and Fabrizio Ferri Benedetti talk with Manny Silva about where documentation and AI meet.

Podcasts like I'd Rather Be Writing Podcast

Episodes

  1. 1

    Podcast: Gathering source material for context input

    ·18m
  2. 2

    Recording of 'Product overviews vs. getting started tutorials: striking a balance between read-first and try-first user behaviors'

    ·49m
  3. 3

    Videocast: Micro content and Flare -- Conversation with Kate Schneider

    ·31m
  4. 4

    The story behind Document360 -- podcast with founder Saravana Kumar

    ·32m
  5. 5

    Playing a product design role as a content designer -- podcast with Jonathon Colman

    ·46m
  6. 6

    A tip for doc reviews -- bring a list of questions

    ·8m
  7. 7

    Writing productivity tip: Focus sessions

    ·0m
  8. 8

    Developer portal strategies for complex landscapes -- conversation with Kristof van Tomme

    ·52m
  9. 9

    API the Docs recording: How Trends in API Documentation Differ from other Tech Comm Trends

    ·32m
  10. 10

    WTD Australia event recording -- 'Remote discussion: Techcomm in the times of pandemic'

    ·1h 11m
  11. 11

    The Emerging Picture of a Changed Profession: Cyborg Technical Writers — Augmented, Not Replaced, by AI

    ·1h 29m
  12. 12

    Will tech writers survive AI? Perspectives from two professors, Nupoor Ranade and Jeremy Merritt

    ·1h 18m
  13. 13

    AI Book Club recording of 'If Anyone Builds It, Everyone Dies'

    ·56m
  14. 14

    Podcast: Doc testing, skills files, and the guardians of knowledge -- with Manny Silva

    ·1h
  15. 15

    AI Book Club recording, notes, and transcript for Sarah Wynn-Williams's Careless People

    ·54m
  16. 16

    Podcast: Tech comm predictions for 2026 (Phase One)

    ·1h 2m
  17. 17

    AI Book Club recording of God, Human, Animal, Machine

    ·56m
  18. 18

    Podcast: Writing as telepathy: AI tools, automation, and an intentionally offline life -- conversation with CT Smith

    ·1h 10m
  19. 19

    AI Book Club recording, notes, and transcript for Ethan Mollick's Co-Intelligence

    ·57m
  20. 20

    Documentation theater and the acceleration paradox -- podcast episode 3 with Fabrizio Ferri-Benedetti

    ·1h
  21. 21

    Recording, transcript, and notes for AI Book Club discussion of Yuval Noah Harari's Nexus

    ·59m
  22. 22

    Recording of AI book club session of 'Hands-On Large Language Models: Language Understanding and Generation', by Jay Alammar and Maarten Grootendorst

    ·1h
  23. 23

    MCP servers and the role tech writers can play in shaping AI capabilities and outcomes -- podcast with Fabrizio Ferri Beneditti and Anandi Knuppel

    ·1h 2m
  24. 24

    Podcast: How AI is changing the role of technical writers to context curators and content directors

    ·54m
  25. 25

    Recording of AI Book Club discussion of Karen Hao's Empire of AI: Dreams and Nightmares in Sam Altman's OpenAI

    ·59m
  26. 26

    Recording of AI Book Club discussion about Kai-fu Lee's AI Superpowers

    ·1h 1m
  27. 27

    Will our next users be AI agents? The future of content delivery with Fabrice Lacroix, founder of Fluid Topics (podcast)

    ·44m
  28. 28

    AI Book Club recording and notes for The Singularity is Nearer, by Ray Kurzweil

    ·56m
  29. 29

    Notes and discussion for Suleyman's <i>The Coming Wave: AI, Power, and Our Future</i> + AI Book Club recording and transcript

    ·1h
  30. 30

    Rethinking traditional approaches to release notes -- recording of WTD Australia presentation

    ·57m
  31. 31

    My 2025 trends predictions for tech comm

    ·21m
  32. 32

    [Podcast] GenAI and Document360: Conversation with Saravana Kumar

    ·50m
  33. 33

    Podcast: Task decomposition and complex tree diagrams

    ·19m
  34. 34

    Podcast: Using long-token contexts to quality check an entire API doc set

    ·22m
  35. 35

    Podcast: Using file diffs for better release notes in reference docs

    ·18m
  36. 36

    Podcast: Populating documentation templates using AI

    ·23m
  37. 37

    [Podcast] Become a technical writer: conversation with Bobby Kennedy about the technical writing courses he offers

    ·0m
  38. 38

    Podcast: Creating high-fidelity, thematically organized notes from engineering meetings using AI

    ·15m
  39. 39

    [Podcast] Uncovering and communicating the value of your tech comm teams' work, with Keren Brown

    ·48m
  40. 40

    [Podcast] Breaking ground: New API documentation course at UW, with Bob Watson

    ·53m
  41. 41

    My 2024 technical writing trends and predictions

    ·28m
  42. 42

    Podcast: Notes and themes from Zen and the Art of Motorcycle Maintenance by Robert Pirsig

    ·1h 3m
  43. 43

    Webinar recording: Experiments and use cases for AI from a tech writer’s perspective

    ·1h 3m
  44. 44

    30+ ways I’m using AI in everyday writing life as a technical writer, blogger, and curious human

    ·45m
  45. 45

    Podcast: The evolution of podcasting, with Ed Marsh

    ·57m
  46. 46

    Presentation recording -- 'Best practices in API docs: Product overviews and getting started tutorials'

    ·1h 2m
  47. 47

    Podcast: Tech writing and Zen and the Art of Motorcycle Maintenance, with Dan Grabski

    ·42m
  48. 48

    Doing research with AI tools -- avoiding the trap of fabricated URLs

    ·15m
  49. 49

    Notes for Building the Cycling City: The Dutch Blueprint for Urban Vitality

    ·47m
  50. 50

    My experience trying to write original, full-length human-sounding articles using Claude AI

    ·38m
  51. 51

    Chatting about AI trends and tech comm with Fabrizio Ferri-Benedetti

    ·49m
  52. 52

    [Podcast] AI and APIs: What works, what doesn't

    ·1h 1m
  53. 53

    Presentation recording: Specialization myopia syndrome and the content journey

    ·51m
  54. 54

    Podcast: All about Redocly, with founder Adam Altman

    ·36m
  55. 55

    Keynote presentation to STC India 2022

    ·57m
  56. 56

    Recording of WTD South Bay presentation: Publishing tools for API documentation

    ·1h 5m
  57. 57

    How to become a voracious reader

    ·7m
  58. 58

    Are technical writers increasingly playing non-technical roles? Some thoughts on the evolution of technical writing roles

    ·27m
  59. 59

    Podcast: Users as producers of knowledge -- conversation with Nupoor Ranade about how tech writer roles are changing

    ·50m
  60. 60

    Webinar recording: How Trends in API Documentation Differ from other Tech Comm Trends

    ·59m
  61. 61

    Introduction to API documentation - Recording from Los Angeles API documentation workshop

    ·1h 28m
  62. 62

    Podcast: How Paligo is filling a niche in the CCMS market for complex documentation, with Anders Svensson

    ·52m
  63. 63

    Podcast with Andrew Davis: Hiring API doc writers -- an inside look at fixing broken processes

    ·55m
  64. 64

    From API docs to developer portals

    ·32m
  65. 65

    Podcast: API Design and Usability with Arnaud Lauret (API Handyman)

    ·55m
  66. 66

    Podcast: Dealing with Project Overload -- Strategies to Manage Overflowing Documentation Tasks

    ·20m
  67. 67

    Podcast: 10 myths about API documentation

    ·32m
  68. 68

    Recording of Tech Comm Trends Presentation (STC Puget Sound chapter)

    ·1h 27m
  69. 69

    Crash course in API documentation -- a one-hour video

    ·58m
  70. 70

    Corporate exodus narratives: A close look at the tension between the corporation and academia

    ·28m
  71. 71

    Recording and slides for my trends presentation at the Symposium for Communicating Complex Information (SCCI)

    ·42m
  72. 72

    How to become a 10X technical writer in the workplace

    ·24m
  73. 73

    How to motivate users to provide feedback: Show that you're listening to their input

    ·10m
  74. 74

    Site analytics from Jan 1 to Dec 31, 2018 -- are more engineers writing docs now?

    ·34m
  75. 75

    Recording for Menlo Park API documentation workshop now available -- and some thoughts on using cardioid versus omnidirectional microphones for recording

    ·11m
  76. 76

    New post in Simplifying Complexity series -- Principle 11: Be both a generalist and specialist at the same time

    ·1h 2m
  77. 77

    How to avoid being a secretary for engineers

    ·27m
  78. 78

    I'd Rather Be Writing is now an Alexa Flash Briefing skill

    ·0m
  79. 79

    Upcoming full-day API documentation workshop in Menlo Park

    ·1m
  80. 80

    Preferring technical acuity over specialized knowledge

    ·13m
  81. 81

    If writing is no longer a marketable skill, what is?

    ·26m
  82. 82

    My conflicted thoughts about the decentralized web (while taking the Census of Technical Communicators survey)

    ·25m
  83. 83

    Articulating stories that influence product adoption (new article in Simplifying Complexity series)

    ·43m
  84. 84

    Reducing the complexity of technical language (new article in Simplifying Complexity series)

    ·43m
  85. 85

    The relationship between academics and practitioners -- Podcast with Kirk St. Amant

    ·56m
  86. 86

    Evaluating the user experience of documentation -- Podcast with Bob Watson

    ·58m
  87. 87

    Recording of API documentation workshop in Denver

    ·3h 51m
  88. 88

    Recording of STC San Francisco presentation: Beyond mere endpoint reference — the overlooked content in API documentation

    ·1h
  89. 89

    Recording of OpenAPI and Swagger presentation (for STC and WTD San Diego)

    ·1h 2m
  90. 90

    How do you communicate user progress in a course without a Learning Management System (LMS)?

    ·14m
  91. 91

    Intro to API Documentation -- recording of presentation to STC Silicon Valley chapter on 11/20/2017

    ·1h 5m
  92. 92

    SwaggerHub: A collaborative platform for working on OpenAPI/Swagger specification files, and more

    ·17m
  93. 93

    Has plain language deepened or ruined our delight in language?

    ·18m
  94. 94

    Discoveries and realizations while walking down the Docs-as-Code path

    ·24m
  95. 95

    Why Stack Overflow's Documentation effort failed -- a few thoughts from a technical writer's perspective

    ·12m
  96. 96

    Tech docs and Agile: Problems with integrating tech writers into engineering Scrums (Part 1)

    ·35m
  97. 97

    Podcast about Archbee -- a new documentation tool with a block-based editor, API publishing capability, content re-use, and more

    Tom Johnson interviews Claudio Descalescu about Archby, a new documentation tool for developers.

    ·29m
  98. 98

    tcworld China 2021 keynote: 'Tech comm and marketing: How to make your tech comm group more visible to those within your company'

    Tom Johnson discusses his experience presenting to a Chinese audience and fills in for another speaker at a technical writing event.

    ·1h 3m
  99. 99

    Notes and discussion for Jonathan Warner's <i>More Than Words: How to Think About Writing in the Age of AI</i> + AI Book Club recording

    A roundtable discussion among technical writers about how AI affects the writing profession.

    ·1h
  100. 100

    MEGAComm recording: How to increase awareness of tech comm inside corporate walls

    Tom Johnson discusses the paradox of being well-known online but feeling invisible within his own company as a tech writer.

    ·53m
  101. 101

    Podcast: How valuable are agent skills? Conversation with Larah Vasquez and Fabrizio Ferri-Benedetti

    Hidden gem

    Tom Johnson, Fabrizio Ferri Benedetti, and Lara Vasquez spend much of the episode on AI tooling for documentation, with Lara tying her Tailscale work to Write the Docs and GitHub.

    Apr 12, 2026·1h 5m·4 clips
  102. 102

    The Emerging Picture of a Changed Profession: Cyborg Technical Writers — Augmented, Not Replaced, by AI

    Hidden gem

    A technical writer discusses current trends and strategies for success in the field.

    Apr 5, 2026·1h 29m·2 clips
  103. 103

    Will tech writers survive AI? Perspectives from two professors, Nupoor Ranade and Jeremy Merritt

    Hidden gem

    Tom Johnson talks with Jeremy Roslett Merritt of James Madison University and Nupur Ranade of Carnegie Mellon University about whether generative AI threatens technical writing.

    Mar 21, 2026·1h 18m·5 clips
  104. 104

    AI Book Club recording of 'If Anyone Builds It, Everyone Dies'

    Hidden gem

    The AI Book Club discusses Nate Soares and Eliezer Yudkowsky’s If Anyone Builds It, Everyone Dies, a book the group repeatedly calls controversial and centered on AI safety and alignment.

    Mar 17, 2026·56m·3 clips
  105. 105

    Podcast: Doc testing, skills files, and the guardians of knowledge -- with Manny Silva

    Hidden gem

    Tom Johnson, Fabrizio Ferri Benedetti, and Manny Silva discuss documentation and AI, with Manny positioning DocDetective and his book Docs as Tests around deterministic checks for procedures, CLI steps, screenshots, and API commands.

    Mar 8, 2026·1h·3 clips
  106. 106

    AI Book Club recording, notes, and transcript for Sarah Wynn-Williams's Careless People

    Four tech workers discuss Sarah Wynn-Williams’s Careless People, weighing its account of Facebook against questions about complicity and hindsight.

    Feb 16, 2026·54m·2 clips
  107. 107

    Podcast: Tech comm predictions for 2026 (Phase One)

    Tom Johnson and Fabrizio Ferdi Benedetti compare 2026 predictions about AI, regulation, and technical writing.

    Jan 25, 2026·1h 2m·2 clips
  108. 108

    AI Book Club recording of God, Human, Animal, Machine

    Tom Johnson’s AI book club discusses Megan O’Giblin’s God, Human, Animal, Machine and its parallels between religion and artificial intelligence.

    Jan 24, 2026·56m·2 clips
  109. 109

    Podcast: Writing as telepathy: AI tools, automation, and an intentionally offline life -- conversation with CT Smith

    Jan 4, 2026·1h 10m
  110. 110

    AI Book Club recording, notes, and transcript for Ethan Mollick's Co-Intelligence

    Dec 17, 2025·57m
  111. 111

    Documentation theater and the acceleration paradox -- podcast episode 3 with Fabrizio Ferri-Benedetti

    Nov 30, 2025·1h
  112. 112

    Recording, transcript, and notes for AI Book Club discussion of Yuval Noah Harari's Nexus

    Nov 22, 2025·59m
  113. 113

    Recording of AI book club session of 'Hands-On Large Language Models: Language Understanding and Generation', by Jay Alammar and Maarten Grootendorst

    Oct 26, 2025·1h
  114. 114

    MCP servers and the role tech writers can play in shaping AI capabilities and outcomes -- podcast with Fabrizio Ferri Beneditti and Anandi Knuppel

    Oct 26, 2025·1h 2m
  115. 115

    Podcast: How AI is changing the role of technical writers to context curators and content directors

    Sep 28, 2025·54m
  116. 116

    Recording of AI Book Club discussion of Karen Hao's Empire of AI: Dreams and Nightmares in Sam Altman's OpenAI

    Sep 22, 2025·59m
  117. 117

    Recording of AI Book Club discussion about Kai-fu Lee's AI Superpowers

    Aug 19, 2025·1h 1m
  118. 118

    Will our next users be AI agents? The future of content delivery with Fabrice Lacroix, founder of Fluid Topics (podcast)

    Jul 5, 2025·44m
  119. 119

    AI Book Club recording and notes for The Singularity is Nearer, by Ray Kurzweil

    Jun 15, 2025·56m
  120. 120

    Notes and discussion for Suleyman's <i>The Coming Wave: AI, Power, and Our Future</i> + AI Book Club recording and transcript

    May 17, 2025·1h
  121. 121

    Notes and discussion for Jonathan Warner's <i>More Than Words: How to Think About Writing in the Age of AI</i> + AI Book Club recording

    Apr 15, 2025·1h
  122. 122

    Rethinking traditional approaches to release notes -- recording of WTD Australia presentation

    Feb 17, 2025·57m
  123. 123

    My 2025 trends predictions for tech comm

    Jan 5, 2025·21m
  124. 124

    [Podcast] GenAI and Document360: Conversation with Saravana Kumar

    Oct 6, 2024·50m
  125. 125

    Podcast: Gathering source material for context input

    Jul 28, 2024·18m
  126. 126

    Podcast: Creating high-fidelity, thematically organized notes from engineering meetings using AI

    Jul 28, 2024·15m
  127. 127

    Podcast: Task decomposition and complex tree diagrams

    Jul 28, 2024·19m
  128. 128

    Podcast: Using long-token contexts to quality check an entire API doc set

    Jul 28, 2024·22m
  129. 129

    Podcast: Using file diffs for better release notes in reference docs

    Jul 28, 2024·18m
  130. 130

    Podcast: Populating documentation templates using AI

    Jul 28, 2024·23m
  131. 131

    [Podcast] Uncovering and communicating the value of your tech comm teams' work, with Keren Brown

    May 30, 2024·48m
  132. 132

    [Podcast] Breaking ground: New API documentation course at UW, with Bob Watson

    Jan 5, 2024·53m
  133. 133

    My 2024 technical writing trends and predictions

    Jan 1, 2024·28m
  134. 134

    Podcast: Notes and themes from Zen and the Art of Motorcycle Maintenance by Robert Pirsig

    Dec 15, 2023·1h 3m
  135. 135

    Webinar recording: Experiments and use cases for AI from a tech writer’s perspective

    Dec 13, 2023·1h 3m
  136. 136

    30+ ways I’m using AI in everyday writing life as a technical writer, blogger, and curious human

    Dec 4, 2023·45m
  137. 137

    Podcast: The evolution of podcasting, with Ed Marsh

    Dec 3, 2023·57m
  138. 138

    Podcast: Tech writing and Zen and the Art of Motorcycle Maintenance, with Dan Grabski

    Nov 18, 2023·42m
  139. 139

    Doing research with AI tools -- avoiding the trap of fabricated URLs

    Nov 9, 2023·15m
  140. 140

    Notes for Building the Cycling City: The Dutch Blueprint for Urban Vitality

    Nov 6, 2023·47m
  141. 141

    My experience trying to write original, full-length human-sounding articles using Claude AI

    Oct 25, 2023·38m
  142. 142

    Chatting about AI trends and tech comm with Fabrizio Ferri-Benedetti

    Oct 20, 2023·49m
  143. 143

    [Podcast] AI and APIs: What works, what doesn't

    Oct 14, 2023·1h 1m
  144. 144

    Presentation recording: Specialization myopia syndrome and the content journey

    Mar 7, 2023·51m
  145. 145

    Podcast: All about Redocly, with founder Adam Altman

    Feb 26, 2023·36m
  146. 146

    Podcast about Archbee -- a new documentation tool with a block-based editor, API publishing capability, content re-use, and more

    Oct 31, 2022·29m
  147. 147

    Keynote presentation to STC India 2022

    Mar 26, 2022·57m
  148. 148

    MEGAComm recording: How to increase awareness of tech comm inside corporate walls

    Tom Johnson discusses the paradox of being well-known online but feeling invisible within his own company as a technical writer.

    Feb 10, 2022·53m
  149. 149

    Presentation recording -- 'Best practices in API docs: Product overviews and getting started tutorials'

    Oct 29, 2021·1h 2m