Code Commenting
Mar 10, 2025•51 min•Season 2Ep. 3
Listen to this episode in Metacast mobile app
Don't just listen to podcasts. Learn from them with transcripts, summaries, and chapters for every episode. Skim, search, and bookmark insights. Learn more
Episode description
In this episode, host Dr. Jill Fennell sits down with Dr. David Torello, Director of the Clark Scholars Program and the College of Engineering's Dean's Scholars Program in the Woodruff School of Mechanical Engineering at Georgia Tech. The two discuss code commenting, an oft overlooked communication genre in Engineering, and consider best practices and use cases for creating effective code comments.
Show Notes and Timestamps:
- 00:54 - Introducing guest
- 02:02 - Code Commenting as Communication
- 03:14 - Purpose of Code Commenting
- 05:44 - Mapping out Communication for Code Commenting
- 09:17 - Genre Expectations for Code Commenting
- 15:33 - Audience needs and Usability of Code Commenting
- 23:02 - Code Commenting Ethos and Impact of Code Comments
- 24:53 - Trustworthiness of Code Comments
- 30:29 - Quality of Code Comments
- 34:15 - Student Perspectives on Code Commenting
- 37:56 - What David wants to see from Code Comments
- 42:04 - Advice for students wanting to keep their skills fresh
- 46:14 - General advice for code commenting and understanding communication
A transcript of this episode is available here.
Episode edited by Lee Hibbard.
For the best experience, listen in Metacast app for iOS or Android