Hacker News Reader

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.

View on HN

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.

Interesting. Maybe I'll rewrite that bit. Thanks for pointing that out.

Reply on news.ycombinator.com