As a base class, this should def. have a class comment and per method comments explaining the interface and how it works and what it does. It is ok if the implementing subclasses don't have that (they probably shouldn't repeat that info), but this interface should be the reference.