
Episode 520: John Ousterhout on A Philosophy of Software Design
Software Engineering Radio - the podcast for professional software developers
00:00
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.
Transcript
Play full episode