Episode
Caring about documentation in the LLM era (w/ Heidi Waterhouse)
- Published
- Jul 24, 2025
- Duration seconds
- 2359
- Processing state
not_requested
Actions
POST https://stenobird.com/v1/public/podcasts/thoughtworks-technology-podcast-1060653/episodes/caring-about-documentation-in-the-llm-era-w-heidi-waterhouse/transcription-requests
Idempotently request low-priority transcript generation for this episode.GET https://stenobird.com/podcast/thoughtworks-technology-podcast-1060653/caring-about-documentation-in-the-llm-era-w-heidi-waterhouse.md
Read the agent-friendly Markdown representation of this episode resource.
Summary
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/