--- Begin Message ---Pharo Smalltalk Developers mailing list wrote > Including what the method does, even when the code is fairly simple > (OK, not getter / setter methods), is still useful.Yes, but... there is no free lunch. While there may be a benefit when the code and comment are freshly written and in sync, they are duplication which smells whether code or comment and it is all too easy for the code to be patched without updating the comment. Now that minor speedup turns into a more significant slowdown when a user blindly follows the now-wrong comment. This possibility is made more likely be the fact that a stale comment will not be picked up by the testing framework. ----- Cheers, Sean -- Sent from: http://forum.world.st/Pharo-Smalltalk-Developers-f1294837.html
--- End Message ---
Re: [Pharo-dev] [Pharo-users] New book: Pharo with Style
Sean P. DeNigris via Pharo-dev Tue, 01 Jan 2019 19:08:36 -0800
- Re: [Pharo-dev] New book: Pharo with S... Stephane Ducasse
- Re: [Pharo-dev] New book: Pharo w... Benoit St-Jean via Pharo-dev
- Re: [Pharo-dev] [Pharo-users] Ne... Alistair Grant via Pharo-dev
- Re: [Pharo-dev] [Pharo-users]... Sean P. DeNigris via Pharo-dev
- Re: [Pharo-dev] [Pharo-us... Esteban Maringolo
- Re: [Pharo-dev] New book: Pharo w... Sven Van Caekenberghe via Pharo-dev
- Re: [Pharo-dev] New book: Pharo w... Tudor Girba via Pharo-dev
- [Pharo-dev] New book: Pharo with ... ducasse