Path: ...!eternal-september.org!feeder3.eternal-september.org!news.eternal-september.org!.POSTED!not-for-mail
From: john larkin <JL@gct.com>
Newsgroups: sci.electronics.design
Subject: Re: Datasheet-flation?
Date: Fri, 29 Nov 2024 07:21:58 -0800
Organization: A noiseless patient Spider
Lines: 35
Message-ID: <almjkjdhii2a9jdtu8007u2cj4ms99rm01@4ax.com>
References: <6vf4kjtqtmhcpab43duk2u7usunavpjaj6@4ax.com> <vhvio7$9k2m$2@paganini.bofh.team> <abp6kjtctamch521osoao98hq97m6499o1@4ax.com> <no4d1lx2hv.ln2@Telcontar.valinor> <vi0qbd$2k2de$1@dont-email.me> <pu5e1lxvli.ln2@Telcontar.valinor> <vi1sen$2p269$2@dont-email.me> <4qtg1lx7ms.ln2@Telcontar.valinor> <vi4j09$3fb75$1@dont-email.me> <422i1lxd1l.ln2@Telcontar.valinor> <vi7j20$3b4e$1@dont-email.me> <m09m1lxq3c.ln2@Telcontar.valinor> <vibd8b$u5qg$2@dont-email.me>
MIME-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 8bit
Injection-Date: Fri, 29 Nov 2024 16:22:01 +0100 (CET)
Injection-Info: dont-email.me; posting-host="91f6c56077a3bd8c399c29b307a15535";
	logging-data="1207394"; mail-complaints-to="abuse@eternal-september.org";	posting-account="U2FsdGVkX1+ApCTQ7gUFNCnXoHraxK/q"
User-Agent: ForteAgent/8.00.32.1272
Cancel-Lock: sha1:/MTBv8Ugqy8P9mB/21z2znXJnt0=
Bytes: 2516

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
/*