Call for Action! ...or "The Holy Crusade Against Empty Class Comments"

Hannes Hirzel hannes.hirzel.squeaklist at bluewin.ch
Thu Apr 18 09:32:53 UTC 2002


Joern Eyrich <Joern.Eyrich at syngenio.de> wrote:
> Didn't Duane Maxwell build some infrastructure for collecting class comments?
> 
The problem is n o t the infrastructure, the problem is the actual
writing of the comments. And that it h a r d work because it is not easy
to come up with useful abstractions in an easy, well written
understandable style. Please do not go into an infrastructure
discussion. Use the time to contribute one or two comments as a [FIX].
Collecting lets say 20 to 50 of these changeSets to a overall comment
changeSet is no big deal for the harvesters. With the mailing list we
have the infrastructure. The ressources which are scare are expert
knowledge, time and writing skills.

HJH

P.S. Squeaks with non-English mother tongue: please do not hesitate to
write comments. You can indicate that a mother-tongue speaker should
check it.



More information about the Squeak-dev mailing list