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/
Popular Podcasts
Stuff You Should Know
If you've ever wanted to know about champagne, satanism, the Stonewall Uprising, chaos theory, LSD, El Nino, true crime and Rosa Parks, then look no further. Josh and Chuck have you covered.
Dateline NBC
Current and classic episodes, featuring compelling true-crime mysteries, powerful documentaries and in-depth investigations. Special Summer Offer: Exclusively on Apple Podcasts, try our Dateline Premium subscription completely free for one month! With Dateline Premium, you get every episode ad-free plus exclusive bonus content.
On Purpose with Jay Shetty
I’m Jay Shetty host of On Purpose the worlds #1 Mental Health podcast and I’m so grateful you found us. I started this podcast 5 years ago to invite you into conversations and workshops that are designed to help make you happier, healthier and more healed. I believe that when you (yes you) feel seen, heard and understood you’re able to deal with relationship struggles, work challenges and life’s ups and downs with more ease and grace. I interview experts, celebrities, thought leaders and athletes so that we can grow our mindset, build better habits and uncover a side of them we’ve never seen before. New episodes every Monday and Friday. Your support means the world to me and I don’t take it for granted — click the follow button and leave a review to help us spread the love with On Purpose. I can’t wait for you to listen to your first or 500th episode!