Re: Datasheet-flation?

On Thu, 28 Nov 2024 20:42:59 -0700, Don Y
<blockedofcourse@foo.invalid> wrote:

On 11/28/2024 6:49 AM, Carlos E.R. wrote:

Do *you* "write for yourself" or "write for others"?
>
I.e., do you write assuming YOU are the Reader?  Or, that
OTHERS will be the Reader?
>
[There seems to be a split on how developers write; I think
this would affect their choice of (spoken) languages as well.]

 
Ah. If I write a script I tend to mix English and Spanish. I tend to use
English thinking of sharing the script or asking questions about it. The places
where I do that are English speaking mostly.

>
I always write for others -- as, if I have to revisit the code
a year or five hence, *I* will effectively BE one of those
"others".

Some guy wrote a c program that strips comments from c programs. His
reasoning is that the code speaks for itself, and the comments are
always wrong.

I assume that program was not commented.


I saw a bit of actual Windows source code, and it had a mandatory,
standard comment section at the start of any block of code. It said

*/
Author:    Jim Smith
Date:         2018
Purpose:  what it says
/*