Path: ...!3.eu.feeder.erje.net!feeder.erje.net!news2.arglkargh.de!news.karotte.org!fu-berlin.de!uni-berlin.de!individual.net!not-for-mail
From: "Carlos E.R." <robin_listas@es.invalid>
Newsgroups: sci.electronics.design
Subject: Re: Datasheet-flation?
Date: Fri, 29 Nov 2024 23:30:59 +0100
Lines: 68
Message-ID: <3urp1lxv75.ln2@Telcontar.valinor>
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>
 <almjkjdhii2a9jdtu8007u2cj4ms99rm01@4ax.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 8bit
X-Trace: individual.net UXJEtdpza0yM+HTV8g/Suw36lNwJGuZ+XFoVkvtrbmaFFtRuq0
X-Orig-Path: Telcontar.valinor!not-for-mail
Cancel-Lock: sha1:Zws3awgRVp+QuvqNz3/ki2sMA6I= sha256:9JBvgHU4Kvnef3h4ZB6/otZayyuBApROLwdh81NC6Vo=
User-Agent: Mozilla Thunderbird
Content-Language: es-ES, en-CA
In-Reply-To: <almjkjdhii2a9jdtu8007u2cj4ms99rm01@4ax.com>
Bytes: 3811

On 2024-11-29 16:21, john larkin wrote:
> 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.

Ridiculous.

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


My first job was as programmer for small company. They had tasked an 
external programmer with creating a software for them with LabWindows. 
This thing creates displays; think a virtual oscilloscope display, for 
instance, measuring things like temperature, pressure, rpm, etc. My boss 
says "I want you to add a voltage display". Simple.

Well, the original programmer had removed the header file that assigned 
labels to both the display windows and the code. The code would say 
"display_crt(31, A1)", where 31 was the element in the display to 
display rpm, for instance. If I inserted "voltage" in the display 
window, all the numbers shifted by one, so that 31 became pressure, for 
instance.

The programmer had sabotaged the code so that no one could touch it by 
replacing labels with their values.

It took me months to recreate the header file with labels. My boss 
thought I was useless: it is difficult to explain this to a non programmer.

I carefully documented since then every program I wrote. I did not want 
any other person to suffer what I did.




-- 
Cheers, Carlos.