Caring about documentation in the LLM era (w/ Heidi Waterhouse)
About this episode
In an age of vibe coding and LLMs, do we really need to care about documentation? Do we need to spend time and energy producing it — time when we could just be shipping code? Of course we do; particularly if we want to communicate and share software with other humans.
To discuss documentation in 2025, Technology Podcast host Lilly Ryan is joined by Heidi Waterhouse, a very special guest with an esteemed and varied career in technical communcation.
In this episode, Lilly and Heidi tackle the challenges of documentation in a world increasingly infused with AI-generated code and text, explore whether prompt engineering is really just technical writing in disguise and examine the difficulties of writing for highly specific audiences.
They also cover Heidi's Progressive Delivery, an upcoming book about bridging the gap between software delivery and business value. It's due to be released in the latter part of 2025 and written alongside James Governor, Kim Harrison and Adam Zimman.
Find out more about Heidi Waterhouse by visiting her website: https://heidiwaterhouse.com/
Learn more about Progressive Delivery: https://itrevolution.com/product/progressive-delivery/
Get every episode summarized
Each time Thoughtworks Technology Podcast publishes, we email you a written briefing from the transcript — the topics, who appeared, and any specific claims, with the ad reads skipped.
Email me new episodesFree for 3 shows. No card needed.
Hosts & guests
No transcript yet
This episode has not been transcribed. Request it and it moves to the front of the queue.
More episodes
More from Thoughtworks Technology Podcast
Open-weight models: What are they and when should you use them?
Thoughtworks Technology Podcast
AI-generated code: What has to be true for us to trust it without looking at it?
Thoughtworks Technology Podcast
Scaling the enterprise harness: How to achieve AI agent controllability across a...
Thoughtworks Technology Podcast
Embracing hybrid AI: How Lenovo is leveraging local, on-device AI
Thoughtworks Technology Podcast