On Fri, Oct 21, 2022 at 9:20 AM Thomas Passin <[email protected]> wrote:

>
> Notice the contingent and pragmatic nature of these (excellent!) comments:
>>
>> - They depend on the actual code: they could not have been written
>> beforehand.
>> - They are *not* part of a general narrative: they discuss low-level
>> details or bugs.
>>
>
> And they are essential for understanding why the code is there and is the
> way it is.  I don't think reading the same code without the comments would
> let any normal person modify or rewrite the code without messing up the
> program's desired operation.
>

Exactly. The comments are essential *and* contingent.

Edward

-- 
You received this message because you are subscribed to the Google Groups 
"leo-editor" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To view this discussion on the web visit 
https://groups.google.com/d/msgid/leo-editor/CAMF8tS3XXM1V4Yoyb-dzVqUA6nDr7tB9985ws9d8sax9iS2ATw%40mail.gmail.com.

Reply via email to