Hi Ben. For me it would make a lot of sense. I have already argued several times that "?" is amazingly hidden. NOBODY can see it. You must have a 5 years Pharo degree to find it ;) The problem is OB, I am not sure if it is supported by OB and if it is, I don't know how to enable it. Moreover, if you take a look to Pharo 1.4 (where OB is not present), you will find that the System Browser in there, has what you want. Cheers On Tue, Dec 27, 2011 at 4:04 PM, Ben Coman <btc@openinworld.com> 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 [1]) 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
[1] Object subclass: #Behavior uses: TPureBehavior instanceVariableNames: 'superclass methodDict format' classVariableNames: 'ObsoleteSubclasses' poolDictionaries: '' category: 'Kernel-Classes'
-- Mariano http://marianopeck.wordpress.com