🚀Breaking Change
Also known as Breaking Update, Incompatible Change, Backwards-Incompatible Change
A change that makes code built on the old version stop working.
Think of it like
Think of it like moving the light switch to the other wall. Everyone who reaches for the old spot hits the wall.
Example
Emma's API renames the field user_name to username. Every app that read the old name now shows a blank. She should have called it version 2.
Why it matters
Others build on your code. An unwarned break can take down apps you have never heard of.
Definition
Common mistake
Key takeaways
- 1Old code stops working. Users must change theirs.
- 2Needs a major version. Under semantic versioning.
- 3Warn first. And give a way over.