tag:blogger.com,1999:blog-18677687.post6141505043277892382..comments2024-03-27T15:13:24.764-04:00Comments on Computer Science Teacher: Comments on Commenting CodeAlfred Thompsonhttp://www.blogger.com/profile/05575057876858763822noreply@blogger.comBlogger3125tag:blogger.com,1999:blog-18677687.post-18770288049007595622021-01-17T20:18:51.405-05:002021-01-17T20:18:51.405-05:00What requires commentary is not just subjective, i...What requires commentary is not just subjective, it depends on the context of the writer. Students in a CS1 course may still find code unfamiliar, and so feel there is value in explaining something that would be a common idiom to more seasoned coders. In the extreme you may get code like:<br /><br /> print("Hello World") # Prints "Hello World"<br /><br />I think it's easy for educators to forget that what seems useless to them may seem helpful to the writer. Perhaps students should be guided to think about what's appropriate to a particular audience.Bryn Jeffrieshttps://www.blogger.com/profile/02006456914463202223noreply@blogger.comtag:blogger.com,1999:blog-18677687.post-75156002545740346222021-01-17T19:11:40.977-05:002021-01-17T19:11:40.977-05:00Comment the heck out of. They are easy to remove ...Comment the heck out of. They are easy to remove later.Garthnoreply@blogger.comtag:blogger.com,1999:blog-18677687.post-83752379013960942082021-01-15T13:13:18.071-05:002021-01-15T13:13:18.071-05:00I fall into the category of one who ‘writes a lot ...I fall into the category of one who ‘writes a lot of comments’. The older I get the more I realize that I use comments as an after the fact reflection on what I just learned. There’s something nice about going to some recently finished code and summarizing it all in comments. It really solidifies a lesson about what I just did. I do encourage my students to use them for the same reason.Markhttps://www.blogger.com/profile/03181904910832819544noreply@blogger.com