Yes I agree. Documentation is a key part of any software, without doc, all is more hard and painful.
I would add also proper naming of things, and not use criptics things as "el", "dr", etc that certainly don't help with the code understanding. Cheers. 2010/12/5 Stéphane Ducasse <[email protected]>: > Hi guys > > I decided that I will not integrate any code that is not documented in Pharo. > > I strongly suggest to remove from Pharo-dev packages whose classes are not > commented. > I'm not sure that I will look at code or answer question to code that is not > commented. > We should change our mindset and it seems that we do not care, so we should > take radical decisions: > less changes, less progress, more comments. > > And for once I will not bash the past. Smalltalk was always with methods > fully documented. > We are just plain lazy and this is a shame. > > Stef >
