61
Is it really a breaking change if a method changes output after an update? (lemmy.world)
submitted 10 months ago by asdfasdfasdf@lemmy.world to c/programming@programming.dev
23 comments fedilink hide all child comments

This might seem obviously "yes" at first, but consider a method like foo.debugRepr() which outputs the string FOO and has documentation which says it is meant only to be used for logging / debugging. Then you make a new release of your library and want to update the debug representation to be **FOO**.

Based on the semantics of debugRepr() I would argue that this is NOT a breaking change even though it is returning a different value, because it should only affect logging. However, if someone relies on this and uses it the wrong way, it will break their code.

What do you think? Is this a breaking change or not?

you are viewing a single comment's thread
view the rest of the comments
[-] kevincox@lemmy.ml 49 points 10 months ago

This is https://www.hyrumslaw.com/.

Basically there are two types of breaking changes:

  1. The change may break something.
  2. The change breaks a contract of the code.

What you are experiencing with debugRepr() is that you have triggered 1. You have made a chance that may break a user. But you have not triggered 2 because the new output is still within the previous contract. What level of stability you want to uphold is up to you.

[-] VoterFrog@lemmy.world 3 points 10 months ago* (last edited 10 months ago)

Which one is important is going to depend on the context for sure.

If it's an open source library, they probably won't care about 1.

If you're working on internal software used by other developers within the company, management probably really does care about 1 because it's going to impact their timelines.

If you're working on a proprietary user-facing API, then even if it doesn't cost your company anything management might still care because it could piss off valuable customers.

I think that, for what ever decision OP is trying to make, looking at that context is more important than quibbling over what exactly constitutes a "breaking change."

this post was submitted on 07 Sep 2023
61 points (96.9% liked)

Programming

16207 readers
1 users here now

Welcome to the main community in programming.dev! Feel free to post anything relating to programming here!

Cross posting is strongly encouraged in the instance. If you feel your post or another person's post makes sense in another community cross post into it.

Hope you enjoy the instance!

Rules

Rules

  • Follow the programming.dev instance rules
  • Keep content related to programming in some way
  • If you're posting long videos try to add in some form of tldr for those who don't want to watch videos

Wormhole

Follow the wormhole through a path of communities !webdev@programming.dev

founded 1 year ago
MODERATORS
snowe@programming.dev
Ategon@programming.dev
MaungaHikoi@lemmy.nz