Some comments on comments
Jon Sachs · ACM SIGDOC Asterisk Journal of Computer Documentation · 1976
My objective here is to set out some (hopefully enlightening) opinions on the writing of comments in computer programs. Programmers probably spend more time writing and reading comments than any other kind of documentation. Thus it is strange that little attention has been given to the problem of making comments as useful as possible.