Class comments

We do use class comments to describe what a class is for, and sometimes how it works. We probably don’t do this often enough, and we probably don’t keep them as up to date as we should.

In my opinion, this argues for stronger focus on writing clear code, not just cracking down on class comments. A developer’s nature is to develop code, not to develop documentation. The best process is one that works with nature, not against it. (Tree-hugger theory of software development.)

Still … for most classes a class comment can be quite useful. Please create them when you create new classes.

Posted on:

Written by: Ron Jeffries

Categorization: Practices

Recent Articles

Scrum Information Base — Agile Skills

Chet Hendrickson and I have offered to help the Scrum Alliance build a broad and growing base of information relating to Scrum / Agile, and to the many skills and practices that can help teams be successful. Our offer has…

Events & Classes

  • No events.