Subj : Re: Software development book recommendation
To   : Adept
From : Nightfox
Date : Tue Mar 18 2025 03:36 pm

  Re: Re: Software development book recommendation
  By: Adept to tenser on Tue Mar 18 2025 09:14 pm

 Ad> But even after things are pretty tight, I _still_ want the comments in
 Ad> there, because it'll explain what was in my head as I wrote the code, and
 Ad> give me a chance of explaining the code in a second way that might make
 Ad> more sense to the next person to come by.

 Ad> Obviously, I'll try to use good variable names, have easy-to-follow code,
 Ad> and so on, but even with perfect code, it's a guarantee that all but the
 Ad> simplest situations will have people with a different mindset coming
 Ad> through and wondering what the heck was going on.

Yeah, I feel like comments are important.  Even if you can follow the code, you'll get an idea of what the code is doing, but not really the why, or the intent behind the code.

Nightfox
--- SBBSecho 3.23-Linux
 * Origin: Digital Distortion: digdist.synchro.net (21:1/137)

.