Sergio Fedi and I are now working on this. As part of the work, we need a "default package comment", akin the the default class comment. The class comment is inspired by CRC idea. Translating CRC to a PRC, we suggest the following, and ask for comments from the community. As I believe we will by the end of the year have a inworld pillar renderer which is fairly stable, the default PRC template could be: 'Please comment me using the following ""template"", ''inspired'' by Class Responsibility Collaborator (CRC) design:
!Package XXX, part of (reference to main package if one exist) one line description: For example, I'm xxx package, containing the hierarchy of visitor objects. ;Responsibiliies :Three sentences about my main responsibility, what I'm doing, what classes do I offer. ;Collaborators :State my related packages, and which classes are the ones used from the outside of the package. !!Public API - message one in class one - message two in class two - what is the way to use this package. One simple example is simply gorgeous. Or refer to which package is the main package if there are several packages in play !!Internal Representation and Key Implementation Points. -Implementation Points, in particular references to classes with good class comments.' Will this work? Best, Sergio & Kasper -- View this message in context: http://forum.world.st/Package-comments-tp4824353p4825838.html Sent from the Pharo Smalltalk Developers mailing list archive at Nabble.com.
