Letters from Readers

Letters From Readers

In January, On VB columnist Joe Kunk wrote a column entitled "To Comment or Not to Comment." This article evoked some spirited debate about the costs and benefits of commenting code. Most respondents vigorously supported commenting, but a few offered a counter argument.

Comments are a clue as to what the developer was thinking when he wrote the comment. As long as you keep that in mind, comments are useful to have. But I'd rather not duplicate info in a comment that's already evident in the code. Sparse, value-added comments are good. Comments for the sake of comments are bad!

Rolling Meadows, Ill.

I've seen places where comments have been useful: for example, if you change code in a way that looks obvious but something unexpected will happen. However, in general, comments clutter the code that's written by experts for experts to read. My guess is that for every time a comment has added to my understanding, there have been an equal number of comments that clouded my knowledge of what was actually going on. I almost never read the comments until I have an understanding of what the code is doing.

New Zealand

While no one can be completely against comments, I kind of fall into the anti-comment camp. I'm a Smalltalk programmer and, to my mind, most Smalltalk code typically has too few comments -- where too few means practically none. But in Smalltalk we (mostly) get away with this because Smalltalk is a good-quality object-oriented language and object-oriented languages tend to result in more readable code. Also, Smalltalk uses named method parameters. Named method parameters make code much easier to follow and make comments much less necessary. I've never understood why most of the object-oriented languages that came after Smalltalk abandoned named parameters in favor of C-style argument lists.

Calgary, Alberta, Canada

About the Author

This story was written or compiled based on feedback from the readers of Visual Studio Magazine.

comments powered by Disqus


  • .NET Core Ranks High Among Frameworks in New Dev Survey

    .NET Core placed high in a web-dominated ranking of development frameworks published by CodinGame, which provides a tech hiring platform.

  • Here's a One-Stop Shop for .NET 5 Improvements

    Culled from reams of Microsoft documentation, here's a high-level summary of what's new for performance, networking, diagnostics and more, along with links to the nitty-gritty details for those wanting to dig in more.

  • Azure SQL Database Ranked Among Top 3 Databases of 2020

    Microsoft touted the inclusion of Azure SQL Database among the top three databases of 2020 in a popularity ranking by DB-Engines, which collects and manages information about database management systems, updating its lists monthly.

  • Time Tracker Says VS Code Is No. 1 Editor for Devs, Some Working 15+ Hours Per Day

    WakaTime, which does time tracking for programmers, released data for 2020 showing that Visual Studio Code is by far the top editor/IDE used by its coders, some of whom are hacking away for more than 15 hours per day.

Upcoming Events