Maintainable cover image

John Ousterhout - It's Not You, It's the Codebase

Maintainable

00:00

The Art of Writing Good Comments

A lot of people don't actually appreciate that good comments are really important. The best interfaces are those where in fact you can completely describe everything people need to know in a very small number of words. And so I think the best way to learn how to write documentation is to be aware as you're reading poorly documented code and think about the kinds of things you wish you knew in order to understand it.

Transcript
Play full episode

The AI-powered Podcast Player

Save insights by tapping your headphones, chat with episodes, discover the best highlights - and more!
App store bannerPlay store banner
Get the app