DiscoverThoughtworks Technology PodcastCaring about documentation in the LLM era (w/ Heidi Waterhouse)
Caring about documentation in the LLM era (w/ Heidi Waterhouse)

Caring about documentation in the LLM era (w/ Heidi Waterhouse)

Update: 2025-07-24
Share

Description

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/

 

Comments 
loading
00:00
00:00
1.0x

0.5x

0.8x

1.0x

1.25x

1.5x

2.0x

3.0x

Sleep Timer

Off

End of Episode

5 Minutes

10 Minutes

15 Minutes

30 Minutes

45 Minutes

60 Minutes

120 Minutes

Caring about documentation in the LLM era (w/ Heidi Waterhouse)

Caring about documentation in the LLM era (w/ Heidi Waterhouse)