25 January 2007

Dewey Defeats Truman

Documentation or comments that are often not kept updated tend to contradict the current implementation of the code they describe or, more often with flower box mavens, are simply copied from one method or class to another without being updated.

Automated comment generation is the next killer app for creating maintainable systems. The simplest possible thing that could work is to copy the same meaningless flower box to every class and member.

Heavily commented/documented codebases are by definition easier to maintain. If you care about the future, you will comment your Data Cloud!

No comments:

Post a Comment