<div dir="ltr">On 3 September 2013 02:19, John Colvin <span dir="ltr"><<a href="mailto:john.loughran.colvin@gmail.com" target="_blank">john.loughran.colvin@gmail.com</a>></span> wrote:<br><div class="gmail_extra"><div class="gmail_quote">
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">On Monday, 2 September 2013 at 03:14:38 UTC, Manu wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="im">
On 2 September 2013 04:00, bearophile <<a href="mailto:bearophileHUGS@lycos.com" target="_blank">bearophileHUGS@lycos.com</a>> wrote:<br>
<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
Manu:<br>
<br>
<br>
 Seriously, how do you quickly read and understand the API through the<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
noise?<br>
<br>
</blockquote>
<br>
The noise increases if you have to repeat the class name for each method<br>
:-)<br>
<br>
</blockquote>
<br></div>
Except that you can _read the class definition_.<br>
<br>
Look, I'm just giving an account of the collective experience from our<br>
weekend. None of us could find anything easily in each others classes, or<br>
quickly get a reasonable overview of it's design and how it worked.<br>
This leads to needless conversations, asking the other person about it, and<br>
all those questions that I should be able to understand at a glance.<br>
This WILL affect productivity in the office.<br>
<br>
The reason was that functions were polluting the class declaration. 9 times<br>
out of 10, when I look at a class declaration, I want to know what it is,<br>
what it has, and what it can do.<br>
</blockquote>
<br>
Code folding? It's a pretty standard feature of most editors since forever.<br>
</blockquote></div><br></div><div class="gmail_extra">I think I've repeated myself 3 or 4 times here, but one more time for good measure...</div><div class="gmail_extra"><br></div><div class="gmail_extra">Requiring IDE assistance to make code _readable_ seems completely fail to me.</div>
<div class="gmail_extra">1) You're not always reading code in your IDE, often in commit logs, diff windows, emails, chat clients.</div><div class="gmail_extra">2) With so much hate for IDE support, it seems like a massive contradiction to say that an IDE should be required to make code readable.</div>
<div class="gmail_extra"><br></div><div class="gmail_extra">Reading code is the most fundamental task in programming. Anything that gets in the way of code readability is an epic fail.</div></div>