1548

How programmers comment their code (lemmy.dbzer0.com)

submitted 4 months ago by Andromxda@lemmy.dbzer0.com to c/programmer_humor@programming.dev

147 comments fedilink hide all child comments

https://nitter.poast.org/denicmarko/status/1774077890281267451

you are viewing a single comment's thread
view the rest of the comments

[-] Honytawk@lemmy.zip 233 points 4 months ago

Same with BIOS descriptions.

FGTSAB switch [toggles the FGTSAB setting]

infuriating

[-] Andromxda@lemmy.dbzer0.com 41 points 4 months ago

I love it

[-] Artyom@lemm.ee 41 points 4 months ago

It's so bad it's almost artistic

[-] jaybone@lemmy.world -4 points 4 months ago

You mean autistic.

[-] Dropkick3038@programming.dev 5 points 4 months ago

An autistic coder would have documented this feature to the point of pedantry.

[-] jaybone@lemmy.world 0 points 4 months ago

And who updates that documentation three months later when a bug gets fixed or a new requirement get implemented?

[-] Dropkick3038@programming.dev 2 points 4 months ago

The person who changed the code, it's just ordinary maintenance. The comments may not execute, but I submit they are as much a part of the program as the executable code. Maybe over time those comments are condensed, or even removed; no different than any other refactoring or cleanup.

[-] BenLeMan@lemmy.world 14 points 4 months ago

Yup, my first thought as well. While those days are thankfully over, those braindead BIOS "help" messages remain etched into my mind forever.

[-] RogueBanana@lemmy.zip 6 points 4 months ago

Are the recent ones any better? I got a gigabyte b660m for 12th gen intel and it's really bad at that. Had to look up a lot to figure out things.

[-] BenLeMan@lemmy.world 3 points 4 months ago

Maybe it's an ASUS thing but both my current and previous boards have been pretty good with the help texts.

[-] Honytawk@lemmy.zip 2 points 4 months ago* (last edited 4 months ago)

Snapmaker Luban is amazing with its help messages.

Every setting in this 3D slicer is completely explained how the setting works, what the different options are, with pictures and even what every option is the most optimal in whatever situation.

Too bad that it isn't the best program unless you have a Snapmaker, and even then...