Listen "Code Commenting"
Episode Synopsis
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 communicationA transcript of this episode is available here.Episode edited by Lee Hibbard.
More episodes of the podcast Communication Mechanics: A Podcast for Engineers
Communicating During Engineering Internships
20/10/2025
Prepping for NSF GRFP Applications
07/04/2025
Engineering Safety Communication
24/03/2025
ZARZA We are Zarza, the prestigious firm behind major projects in information technology.