Code Commenting

10/03/2025 51 min Temporada 2 Episodio 3
Code Commenting

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