The best code comment is, objectively, from the Unix source code: “You are not expected to understand this”
LMAO the "too scared to delete" one is so relatable.
"The quality of this coming section is severely compromised due to my lack of understanding of what I'm doing."
my favorite was that one comment block about the psd file format: // At this point, I'd like to take a moment to speak to you about the Adobe PSD format. // PSD is not a good format. PSD is not even a bad format. Calling it such would be an // insult to other bad formats, such as PCX or JPEG. No, PSD is an abysmal format. Having // worked on this code for several weeks now, my hate for PSD has grown to a raging fire // that burns with the fierce passion of a million suns. // If there are two different ways of doing something, PSD will do both, in different // places. It will then make up three more ways no sane human would think of, and do those // too. PSD makes inconsistency an art form. Why, for instance, did it suddenly decide // that these particular chunks should be aligned to four bytes, and that this alignement // should not be included in the size? Other chunks in other places are either unaligned, // or aligned with the alignment included in the size. Here, though, it is not included. // Either one of these three behaviours would be fine. A sane format would pick one. PSD, // of course, uses all three, and more. // Trying to get data out of a PSD file is like trying to find something in the attic of // your eccentric old uncle who died in a freak freshwater shark attack on his 58th // birthday. That last detail may not be important for the purposes of the simile, but // at this point I am spending a lot of time imagining amusing fates for the people // responsible for this Rube Goldberg of a file format. // Earlier, I tried to get a hold of the latest specs for the PSD file format. To do this, // I had to apply to them for permission to apply to them to have them consider sending // me this sacred tome. This would have involved faxing them a copy of some document or // other, probably signed in blood. I can only imagine that they make this process so // difficult because they are intensely ashamed of having created this abomination. I // was naturally not gullible enough to go through with this procedure, but if I had done // so, I would have printed out every single page of the spec, and set them all on fire. // Were it within my power, I would gather every single copy of those specs, and launch // them on a spaceship directly into the sun. // // PSD is not my favourite file format.
Once i found a comment in the legacy code of my current job that said “this either works flawlessly or im an optimistic fucking idiot”. We all loved it so much we agreed we’d never delete it. The guy who wrote that was long gone from the company.
//This breaks in production, has to be fixed Commited by redacted 6 years ago.
I don't delete code, I just turn it into a comment, check if it still works and if it does, I either delete it, or just leave it there in case I need it in future
Years ago I worked with the guy for whom English was a second language. He struggled with English even more than C++. He had the hilarious habit of beginning every comment with “here I am…“ as in “here I am entering a critical section”.
I remember one day, I was coding at 3am and put "3am coding, I have no idea what it does but it works"
My favourite one Spent 5 hours optimising this code but failed, increase the counter if you tried and failed
As someone still fairly new to coding the afraid to delete one rings very true lol
“Too scared to delete” is something every single dev has felt.
Bro is closing single-line comments 😭😭
Me showing my wife the new movement mechanic's on a game Im working on Her : how did you do that Me : honestly, I don't know
The comments on my open source repo are hilarious There's one //Its at this moment i knew i had run mad 🤣🤣
... "auto generated" is a very common comment for scaffolding software to make. it doesn't indicate scary anything. it just means that if the scaffolder is run again any of your changes will be replaced because you are supposed to put your changes elsewhere. why are you pretending it's something more exciting than it is?
>closing a comment with // what?
/*I made this on scratch when I was Eight. Only an eight year old will understand it, because I do not*/
I have done a few programming blunders. One was actually more of a communicative blunder, because an error message I wrote was complete nonsense, where the tip given to the user was "Please support the environment you run it in supports ES6 module imports". In the commit message where I corrected that I wrote "What the hell was I writing?!?" XD
@whitetoggled5546