On 2 September 2013 04:00, bearophile <bearophileHUGS@lycos.com> wrote:
Manu:


Seriously, how do you quickly read and understand the API through the noise?

The noise increases if you have to repeat the class name for each method :-)

Except that you can _read the class definition_.

Look, I'm just giving an account of the collective experience from our weekend. None of us could find anything easily in each others classes, or quickly get a reasonable overview of it's design and how it worked.
This leads to needless conversations, asking the other person about it, and all those questions that I should be able to understand at a glance.
This WILL affect productivity in the office.

The reason was that functions were polluting the class declaration. 9 times out of 10, when I look at a class declaration, I want to know what it is, what it has, and what it can do.