Skip to content

Commit ef6d955

Browse files
Add a note on breaking changes
1 parent 03640a3 commit ef6d955

File tree

1 file changed

+8
-2
lines changed

1 file changed

+8
-2
lines changed

bundler/doc/playbooks/RELEASING.md

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -23,8 +23,14 @@ break backwards compatibility should (whenever this is possible) include a featu
2323
release that is backwards compatible, and issue warnings for all options and
2424
behaviors that will change.
2525

26-
We try very hard to only release breaking changes when incrementing the _major_
27-
version of Bundler.
26+
We only release major breaking changes when incrementing the _major_ version of
27+
Bundler and RubyGems. However, experience shows that almost every single part of
28+
Bundler and RubyGems is depended on by someone in ways hard to anticipate. So if
29+
we were strict about breaking changes we'd need to hold on from making progress
30+
a lot, or continuously increment the major version, emptying "really major"
31+
versions from their meaning. Because of this, we also may release "small"
32+
breaking changes in minor releases. "Small" here means that we expect them to
33+
affect only very few users in rare cases.
2834

2935
### Patch && minor releases
3036

0 commit comments

Comments
 (0)