News for hackers. Stuff that matters.
Re:Clean Ruby by saturnflyer on Thursday December 08, 2011 @12:46AM (#3327872)
This book isn't an argument against documentation. Until the recent advent of DCI there was no programming paradigm that brought the algorithm to be a first class citizen. Tomdoc looks great, but it only describes methods or classes. Documentation will not tell you what will happen among a network objects during runtime, DCI will.
Re:Clean Ruby by igorgue on Thursday December 08, 2011 @01:02AM (#3327923)
Got it.

"While following the Model View Controller approach has made your code cleaner, and following conventions have reduced the need for documentation, there’s still plenty of room for improvement and too much time needed to instruct new developers."

That made me think that the goal was writing less documentation.

Re:Clean Ruby by saturnflyer on Thursday December 08, 2011 @01:05AM (#3327935)
Interesting. Maybe I'll rewrite that bit. Thanks for pointing that out.