<br><br><div class="gmail_quote">On Sun, Feb 27, 2011 at 10:03 PM, Francois Stephany <span dir="ltr">&lt;<a href="mailto:tulipe.moutarde@gmail.com">tulipe.moutarde@gmail.com</a>&gt;</span> wrote:<br><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">
I find it frustrating to load a package and to have no clue where to start. The user must scan the classes and guess which one are &#39;entry points&#39;. Class comments does not help there.<br>
<br>
For a user perspective I would prefer to have a HelpSystem indicating where to start. </blockquote><div><br>+99<br>Exactly. The few times I needed class comments, the problem was exactly that one: which classes, which where the entry point. <br>
 </div><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">Now I guess class comments are useful when you&#39;re hacking/refactoring.<div class="im">
<br>
<br>
On 27/02/11 19:49, Mariano Martinez Peck wrote:<br>
</div><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;"><div class="im">
<br>
<br>
On Sun, Feb 27, 2011 at 4:18 PM, Stéphane Ducasse<br></div><div><div></div><div class="h5">
&lt;<a href="mailto:stephane.ducasse@inria.fr" target="_blank">stephane.ducasse@inria.fr</a> &lt;mailto:<a href="mailto:stephane.ducasse@inria.fr" target="_blank">stephane.ducasse@inria.fr</a>&gt;&gt; wrote:<br>
<br>
    Hi<br>
<br>
    why can we put comment in class comment?<br>
    For example I worked on fixing 1.2 and now I want to execute the<br>
    configurationOfPharo and no magic invocation....<br>
    JUST A FUCKING EMPTY class comment as usual.<br>
<br>
<br>
    So again I feel like an idiot and I&#39;m trying in the dark. You have<br>
    NOT A SINGLE REASON NOT TO PUT COMMENT!<br>
    One of these days I will hack the system to break the load when a<br>
    class as no comment.<br>
<br>
<br>
I was the original author of such class. And yes, I don&#39;t write class<br>
comments. I am not use too, usually because:<br>
<br>
- I almost don&#39;t find it use<br>
- The browser doesn&#39;t help me to see class comments<br>
- Who can guess that under a &#39;?&#39; there are class comments? I discovered<br>
that YEARS after I was already using Smalltalk<br>
- I prefer writting/reading a TestCase for such class (I know it is not<br>
the same as class comments, but it helps).<br>
- I prefer looking at senders/references to such class<br>
- When class comments are long, the browser is FUCKING slow to write<br>
<br>
Even more, in this case, what would you write for example?<br>
ConfigurationOf* are just Metacello Configurations. What would you need<br>
to know about that despite of Metacello?  If you know Metacello, you<br>
should know how to query the configuration and get all the things you<br>
want, like groups, packages, etc<br>
<br>
<br>
    So now after randomly trying.....I get a nice DNU.<br>
<br>
<br>
But do you think that could be fixed just because of having class comments?<br>
<br>
    Apparently my time is not worth anything....<br>
<br>
    So if you want to see if my fix works. Give a try I will not and if<br>
    what I did break, may be I will have a look or may be not<br>
    because no time for that after.<br>
<br>
<br>
    And BTW do not put any comment, it feels much cooler that way.<br>
<br>
    Stef<br>
<br>
<br>
<br>
</div></div></blockquote>
<br>
</blockquote></div><br>