this post was submitted on 29 Mar 2024
977 points (98.3% liked)

Programmer Humor

19623 readers
26 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
 
you are viewing a single comment's thread
view the rest of the comments
[–] [email protected] 15 points 8 months ago (3 children)

Was there much value in the refactoring, like tech debt addressed?

[–] [email protected] 57 points 8 months ago (3 children)

Doesn't matter. One concern per PR. Refactoring and tech debt are separate concerns.

CC BY-NC-SA 4.0

[–] [email protected] 26 points 8 months ago (1 children)

Or, if the team does allow refactoring as part of an unrelated PR, have clean commits that allow me to review what you did in logical steps.

If that's not how you worked on the change than you either rewrite the history to make it look like you did or you'll have to start over.

[–] [email protected] 2 points 7 months ago

Very good point. We often do one PR per story so people tend to think that's a limit.

[–] [email protected] 8 points 7 months ago (2 children)

You should refactor as needed as you go because refactoring cases are never gonna be prioritised.

[–] [email protected] 3 points 7 months ago (1 children)

Not with that attitude they won't 😛

Refactoring in PRs just makes it more difficult to review. "Do these lines belong to the goal nor not?". Also, we're human and miss things. Adding more text to review means the chance of missing something increases.
Especially if the refactored code isn't just refactored but modified, things are very easy to miss. Move an entire block of code from one file to another and make changes within = asking for trouble or a "LGTM" without any actual consideration. It makes code reviews more difficult, error-prone, and annoying.

Code reviews aren't there to just tick off a box. They are there to ensure what's on the tin is actually in it and whether it was done well.

CC BY-NC-SA 4.0

[–] [email protected] 3 points 7 months ago (1 children)

In my experience I haven't had an issue because usually the refactorings are small. If they're not I just hop on a call with the person who wrote the MR and ask them to walk me through it.

In theory I'd like to have time to dedicate solely to code health, but that's not quite the situation in basically any team I've been in.

[–] [email protected] 1 points 7 months ago

I haven't had any trouble separating refactors PRs from ticket PRs. Make the ticket PR, make a refactor PR on that ticket PR, merge the ticket PR, rebase refactor PR on master, open ticket PR for review, done 🤷

CC BY-NC-SA 4.0

[–] [email protected] 1 points 7 months ago

I have a rule about this (not that I don't break it at times). I only refactor in an unrelated story if it doesn't delay deliverables and existing tests cover the code.

And you're generally right about tech that not being prioritized, but you should have a talk with your product manager/owner to strike a deal for some small percentage of your work to include tech debt. We were able to convince ours that it was otherwise affecting our velocity.

[–] [email protected] 2 points 8 months ago
[–] [email protected] 6 points 8 months ago

A tiny bit of value, but definitely not worth the pain and effort. It wasn’t exactly any technical debt that hindered our development.

We had other places with way more pressing technical debt that could’ve been focused on instead.

[–] [email protected] 4 points 8 months ago (1 children)

I hear you, but they should MVP the ticket, close it, then concisely collar the PM/lead and say "I know how to make this better and am hungry to do it. Let me address some tech debt next sprint. I got this and will keep it timeboxxed. I'll also ensure my changes pass QA before coming to you"

[–] [email protected] 9 points 8 months ago (1 children)

Refactors should be a natural part of development or you will have a shit code base

[–] [email protected] 10 points 8 months ago (1 children)

Sure, now imagine you've been obligated to adopt a legacy codebase.

Life isn't a classroom.

[–] [email protected] 1 points 7 months ago

That's pretty much all I have been doing in my 8 year career