3min chapter

Software Engineering Radio - the podcast for professional software developers cover image

Episode 520: John Ousterhout on A Philosophy of Software Design

Software Engineering Radio - the podcast for professional software developers

CHAPTER

How to Keep Your Comments Up to Date

The ability to make bad comments is not a reason to have no comments thinkings. Don't use the same words, or worse, the comments don't match what the implementation actually does. The closer your documentation lives to the abstractions and implementations, the more likely it will be kept up to date. Softwer should be designed for ease of reading, not ease of writing.

00:00

Get the Snipd
podcast app

Unlock the knowledge in podcasts with the podcast player of the future.
App store bannerPlay store banner

AI-powered
podcast player

Listen to all your favourite podcasts with AI-powered features

Discover
highlights

Listen to the best highlights from the podcasts you love and dive into the full episode

Save any
moment

Hear something you like? Tap your headphones to save it with AI-generated key takeaways

Share
& Export

Send highlights to Twitter, WhatsApp or export them to Notion, Readwise & more

AI-powered
podcast player

Listen to all your favourite podcasts with AI-powered features

Discover
highlights

Listen to the best highlights from the podcasts you love and dive into the full episode