[Pharo-project] Better documenting and consistency

Hi all today I wanted to finish my ThreadSafeTrasncript so I started to code buildWith: aBuilder "(self buildWith: MorphicToolBuilder new) openInWorld" ^self new buildWith: aBuilder and open open "self open" ^ (self buildWith: MorphicToolBuilder new) openInWorld and I realised that I do not know what open should return. Should it return the window or the model. I could not figure out I tried to understand what buildWith: should return but it was totally unclear Having better comment than buildWith: aBuilder ^self subclassResponsibility is needed if we want to continue to bash Java people. So what do we do? Stef