That's basically what comments are most useful for. When you're doing something that's not obvious, and want to make sure the "why" doesn't get lost to time.

[–] kubica@fedia.io 95 points 2 months ago (2 children)

// I'm not really that dumb, there is a reason.

[–] DarkDarkHouse@lemmy.sdf.org 41 points 2 months ago

// narrator: the reason was management

[–] NotMyOldRedditName@lemmy.world 35 points 2 months ago* (last edited 2 months ago) (1 children)

// I told them I'd do this but only if they gave me time next sprint to fix it  - 12-03-1997

[–] MostlyBlindGamer@rblind.com 15 points 2 months ago

[flashbacks to the backlog being wiped out because “the client already signed off on the release”]

[–] ChickenLadyLovesLife@lemmy.world 12 points 2 months ago (1 children)

I spent a year making my company's iOS apps accessible (meaning usable for the blind and people with vision disabilities). I had to do a lot of weird shit either because of bugs in Apple's VoiceOver technology or because of the strange way in which our code base was broken up into modules (some of which I did not have access to) and I would always put in comments explaining why I was doing what I was doing. The guy doing code review and merges would always just remove my comments (without any other changes) because he felt that not only were comments unnecessary but also they were a "code smell" indicating professional incompetence. I feel sorry for whoever had to deal with that stuff at a later point.

[–] sukhmel@programming.dev 2 points 2 months ago (1 children)

Well, this is shitty

I hope the reviewer did not also squash commits, and the next programmer would be able to at least dig what was there.

Doing changes after some rockstar dev implemented some really complex service, but left no clues as to what does what is so frustrating, and I can never be sure that I don't break anything in a different place completely

[–] ChickenLadyLovesLife@lemmy.world 3 points 2 months ago

I meant to say commits and not merges, and yes he removed the comments before committing. It made no difference in long run because every new release broke all the accessibility stuff anyway. It's amazing how little developers can be made to care about blind people - almost as little as managers. The only reason my company cared at all was they were facing million-dollar-a-month fines from the FCC.