Documentation

As with most things in software development the ultimate currency for comments is time. This is an analysis of the costs and benefits of comments.

To discuss the up- and downsides of comments we need to know what exactly we are talking about. Categorizing and characterizing different kinds of comments is an important preparatory step.

Matt Werner from DZone interviewed me about my stance on comments.