Hi Stéphane,

I won't reply to each point in your last message, because the amount of 
quoted text is getting to be too unwieldy. So here's a much shorter 
version:

About class comments. I agree that class comments are important, but I 
don't think what I posted earlier in this thread should go into them. I 
like to keep the class comment focused on the class its self - its 
responsibilities and the other objects it collaborates with. 
Big-picture explanations and tutorials can go elsewhere. I have some 
ideas for an active essay I'd like to write soon, and the OmniBrowser 
wiki also has documentation. Although it hasn't been updated recently, 
it's still accurate; the core of OB hasn't changed in quite a while. 
(See http://www.wiresong.ca/OmniBrowser/Docs/)

About categorizing methods: I don't think there are very many 
uncategorized methods in OB. I'm really annoyed by that, so I tend to 
categorize them as I go. Also, I've made Ned's ENH available in 
OmniBrowser. I think the menu item is something like "categorize 
automatically."

About the hierarchy browser: I wonder if you were thinking of 
OBInheritanceBrowser. It displays the inheritance of methods, not 
classes.

Colin