"cdrick" <cdrick65 at gmail.com> wrote

> For instance, I find the seaside-callbacks category would be better
> explained in its globality first. Class comment provide then more
> precise information (especially when there is a hierarchy).
>
> Do you think it would be useful too?

Useful? I would say essential. At the level of package & class category. In 
order of usefulness, imho:

- package description
   - class category description
      - class & method category description

> An
> easy way would be to add a empty class dedicated to wrinte comments

Are packages and class-categories not first-class objects in squeak?

Sophie