Comments on Comments
http://www.contentwithstyle.co.uk/Articles/97/comments-on-comments/

Opitz, Pascal
Content with Style
2006

Abstract:

The right kind of comments to speed up the development process and enable a couple of interesting possibilities to generate documentations automatically. This article tries to reflect on the pros and cons of comments and to show some interesting possibilities for automatic comment parsing. Comment Basics