Subj : Re: RIP Niklaus Wirth
To   : Dr. What
From : Adept
Date : Mon Feb 19 2024 20:05:47

 DW> I've dealt with (and still deal with) some developers who have an
 DW> attitude of "I don't need to document it.  It's self-evident."  Ya, to
 DW> you, who did the research and wrote it.  But it's greek to someone else
 DW> who didn't.

Yeah. This is also why I have problems with the various code style things that are anti-comments.

Because I want comments to tell me what was in the developer's head at the time the things were made. Yeah, it _might_ not be updated, but it'll help me more quickly understand the edge cases, or why the section exists at all.

And then I _also_ don't have to figure out if some well-named variable means what I think it means, or _almost_ what I think it means, because theoretically the comment explained the concept well.

But my code tends to start with comments, slowly expand out to be a ton of comments with some amount of code, then less code and slightly-more-than-I-started-with amount of comments.

--- Mystic BBS v1.12 A48 (Linux/64)
 * Origin: Storm BBS (21:2/108)

.