<div dir="ltr">Hi there, as we go to fix comments, may we take the opportunity to see if we'd like to change the nature of the comment in general?<div><br></div><div>Here's where I'm going:  "built-in documentation".  For all #firstComments anyway, in methods throughout the system, if we would direct those particular comments toward the *Dynabook user*, something like:</div><div><br></div><div>   "Answer whether the receiver can be sent a message named aSymbol."</div><div><br></div><div>then relatively simple systems can easily extract it to help connect users to a Dynabook experience.  Separate comments can be used to describe the 'dictionarys' or whatever implementation if desired, but since they wouldn't be the #firstComment, they wouldn't be presented in the user layer.<br></div><div><br></div><div>It's a simple but powerful leverage, what do you think?</div><div><br></div><div>Best,</div><div>  Chris</div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Mon, Aug 5, 2019 at 9:39 AM <<a href="mailto:commits@source.squeak.org" target="_blank">commits@source.squeak.org</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">A new version of Kernel was added to project The Inbox:<br>
<a href="http://source.squeak.org/inbox/Kernel-cmfcmf.1251.mcz" rel="noreferrer" target="_blank">http://source.squeak.org/inbox/Kernel-cmfcmf.1251.mcz</a><br>
<br>
==================== Summary ====================<br>
<br>
Name: Kernel-cmfcmf.1251<br>
Author: cmfcmf<br>
Time: 5 August 2019, 4:39:08.95825 pm<br>
UUID: eb7ae4e2-7697-7745-b4c3-4f9ce5975e2b<br>
Ancestors: Kernel-mt.1250<br>
<br>
Clarify comment in Object>>respondsTo: to indicate that the method can also be defined in a superclass.<br>
<br>
=============== Diff against Kernel-mt.1250 ===============<br>
<br>
Item was changed:<br>
  ----- Method: Object>>respondsTo: (in category 'class membership') -----<br>
+ respondsTo: aSymbol<br>
+       "Answer whether the method dictionary of the receiver's class or any of its superclasses contains <br>
- respondsTo: aSymbol <br>
-       "Answer whether the method dictionary of the receiver's class contains <br>
        aSymbol as a message selector."<br>
<br>
        ^self class canUnderstand: aSymbol!<br>
<br>
<br>
</blockquote></div>