603
all 47 comments
sorted by: hot top controversial new old
[-] ryan@the.coolest.zone 118 points 8 months ago

Let him play in the legacy code. You can just hose him off later before letting him back into the office so he doesn't track it everywhere.

[-] ISometimesAdmin@the.coolest.zone 57 points 8 months ago

Unfortunately if you let Junior play in legacy code once, it'll learn some nasty habits and make more of it from scratch, usually when you're trying to sleep.

[-] Hazzia@discuss.tchncs.de 14 points 8 months ago

It's true, spaghettification sauce stains clothes. Best keep Jr out of it entirely.

[-] MagicShel@programming.dev 10 points 8 months ago

I don't want that shit all over me though. That's why I hired junior!

[-] MonkderZweite@feddit.ch 2 points 8 months ago* (last edited 8 months ago)

That's what the line represents. So they can pull you if you do something nasty.

[-] mbp@lemmy.sdf.org 3 points 8 months ago

God, I would love that so much

[-] MamboGator@lemmy.world 88 points 8 months ago

The junior doesn't know that these aren't unused functions. They're load bearing functions.

[-] sbv@sh.itjust.works 15 points 8 months ago
[-] Killing_Spark@feddit.de 4 points 8 months ago
[-] bappity@lemmy.world 49 points 8 months ago* (last edited 8 months ago)

me when first starting out at a job commenting everything I can
VS
me a couple years in completely lost because I never updated the comments and now none of them make any sense whatsoever

[-] xmunk@sh.itjust.works 54 points 8 months ago

Commenting well is a highly advanced skill. I generally prefer no comments on code since it's less likely to confuse people and I'll merrily purge auto-doc comments and anything like

// getId() returns an id

That comment has negative value.

[-] kubica@kbin.social 23 points 8 months ago

I can't help it, I always get the mental image of hands clapping sarcastically when I see something like that.

[-] platypode@sh.itjust.works 9 points 8 months ago

In my experience refactoring lots and lots of crappy code left by devs long gone, a dev who can write useful comments is by and large a dev who can write code clean and simple enough not to need them. If the code doesn't have informative names and clear separation of concern, chances are a comment won't help because the dev didn't really know what they did that worked in the first place.

[-] MagicShel@programming.dev 12 points 8 months ago

Generally, yes. However I have been known to document exactly why I'm doing something incredibly stupid - because it's required but a stupid third party library which, despite being awful, is still better than implementing it myself as a refactor.

[-] bappity@lemmy.world 3 points 8 months ago

a dev who can write useful comments is by and large a dev who can write code clean and simple enough not to need them.

my boss is great in this regard and also always has to keep reminding us to write unit tests 😅

[-] magic_lobster_party@kbin.social 8 points 8 months ago

Comments should only be used to describe stuff that’s otherwise difficult to convey with code.

[-] xmunk@sh.itjust.works 15 points 8 months ago

The best explanation I've ever heard is:

Comments should state the 'Why' never the 'What'.

[-] hikaru755@feddit.de 1 points 8 months ago

There are some cases though where the code is just complicated for reasons outside of your control, in which case "what" comments are good - but they should never be taken at face value, but only used as a first step in understanding the code. There's a significant risk of the code not actually doing what the comment says.

[-] dukk@programming.dev 3 points 8 months ago

Yeah. Most of the time I use comments in my algorithms, as they often use some weird optimized black magic which are difficult to understand without comments.

[-] DoomBot5@lemmy.world 1 points 8 months ago

Like don't set this value to the obvious default. Bad stuff happens

[-] bear@slrpnk.net 6 points 8 months ago

I write a lot of fairly simple scripts in Bash and PowerShell that should be easily understood by anybody else with moderate experience in the language, but I leave a lot of obvious comments because my coworkers don't write any code and are extremely skittish about my automations. I add them basically to quell their fears.

[-] odium@programming.dev 9 points 8 months ago

Why are coworkers who don't write any code in the codebase?

[-] bear@slrpnk.net 7 points 8 months ago* (last edited 8 months ago)

These are scripts that manage stuff on a few hundred user endpoints and a few servers. They were doing basically everything manually until I got here, and the only way I could get them on board with my slow introduction of automation is to let them see it. I have to ensure things don't get too long, complex, or hard to explain, or they start getting nervous.

[-] oce@jlai.lu 3 points 8 months ago

I'd rather teach people to comment well through my reviews. Much easier to understand two lines of well written function description in English than 20 lines of code.

[-] pennomi@lemmy.world 25 points 8 months ago

The leash is good unit testing.

[-] gjoel@lemmy.ml 6 points 8 months ago

Oh, he'll just change the unit test if it fails.

[-] Killing_Spark@feddit.de 3 points 8 months ago

Unit tests are there to get an @ignore annotation!

[-] magic_lobster_party@kbin.social 22 points 8 months ago

There’s also that long time senior dev who’s overly confident in their abilities and force pushes production breaking code directly to master.

[-] Anticorp@lemmy.ml 11 points 8 months ago
[-] magic_lobster_party@kbin.social 8 points 8 months ago

Nah, they’re the one who’s contributing most to the project. Mostly because their code is so garbage no one else can work with it. But that’s not a thing the managers take into account.

[-] jelloeater85@lemmy.world 8 points 8 months ago

Yeet that shit into main. Who needs unit tests, it works on my computer?

[-] magic_lobster_party@kbin.social 6 points 8 months ago

If it works in my mind it’s ready for production

[-] wizardbeard@lemmy.dbzer0.com 3 points 8 months ago

YOLOdev is the best way to dev

[-] Strawberry@lemmy.blahaj.zone 1 points 8 months ago

This shit happened the other week for me. Senior dev pushed the shittiest JS code without testing the day of a production install and it caused us to have to roll back the install after it very predictably caused a bunch of crashes for pages on our public site. Worst part is, the entirety of what he wrote could've been implemented as a CSS media query

[-] XTornado@lemmy.ml 15 points 8 months ago

Make him unit test it all and then they can do changes that don't break.

[-] justJanne@startrek.website 8 points 8 months ago

Often enough, the old code is so badly intertwined that it's impossible to actually test. Those are the moments where all you can do is nuke it from orbit.

[-] XTornado@lemmy.ml 3 points 8 months ago* (last edited 8 months ago)

Well I was going for that... They will surrender before they do any changes.

[-] southsamurai@sh.itjust.works 2 points 8 months ago

Why is the junior dev tied to the other one's penis?

[-] ButtCheekOnAStick@lemmy.world 12 points 8 months ago

Because everyone sucks at drawing hands

[-] morrowind@lemmy.ml 10 points 8 months ago

Bro that's not where the penis is located on the body

[-] southsamurai@sh.itjust.works 2 points 8 months ago

Hey, I don't body shame

[-] WhiskyTangoFoxtrot@lemmy.world 1 points 8 months ago* (last edited 8 months ago)
this post was submitted on 24 Oct 2023
603 points (97.8% liked)

Programmer Humor

18253 readers
2130 users here now

Welcome to Programmer Humor!

This is a place where you can post jokes, memes, humor, etc. related to programming!

For sharing awful code theres also Programming Horror.

Rules

founded 1 year ago
MODERATORS