[Pharo-project] System Browser - shifting class comments into pane beneath class definition
krishnamachari.sudhakar at gmail.com
Sun Jan 1 01:27:34 EST 2012
I would also state that the compilation should fail if there is no change to the default class comment when a method is written and saved.
Aggessively expect even methods to have at least some comment, unless they are accessors or the likes.
Will force the habit for future incremental code
On Dec 27, 2011, at 9:21 PM, Stéphane Ducasse <stephane.ducasse at inria.fr> wrote:
> This is good point.
> we should give more space to class comments.
> On Dec 27, 2011, at 4:04 PM, Ben Coman wrote:
>> I could not find any previous discussion of this so I'll just throw this out there...
>> I find that I forget to click the "?" button to read the class comments as I browse around the system. They are "kind of" hidden. Perhaps also I stop looking because they are often empty. If others do the same then it is a downward spiral... if it seems no one looks at them then no one values writing them. (Except for the good work of the COTDC)
>> However System Browser opens by default with 16 lines.
>> Most class definitions (eg ) use 6 lines, which leaves a lot of unused whitespace.
>> I wonder if the class comment was to appear (in a separate pane) beneath the class definition then the class definition would be filled out more often. Bring the class comments to the fore and perhaps they'll be valued more. At least for me, it will ensure that I don't miss where there are good comments I can learn from. Also more attention may focus on the poor comments due to being more exposed.
>> just a random thought...
>> cheers, Ben
>>  Object subclass: #Behavior
>> uses: TPureBehavior
>> instanceVariableNames: 'superclass methodDict format'
>> classVariableNames: 'ObsoleteSubclasses'
>> poolDictionaries: ''
>> category: 'Kernel-Classes'
More information about the Pharo-dev