You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
changed "almost any change in behavior could result breaking someone" to be "almost any change in behavior could cause a logic error for a consumer".
I very much doubt the author intended to say "breaking someone", maybe "breaking something" and that's why I added 'for a consumer'. Personally I prefer "almost any change in behavior could cause a logic error" but will leave it changed as-is to keep as close to what I believe is the authors intent.
Copy file name to clipboardExpand all lines: docs/standard/library-guidance/breaking-changes.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -44,7 +44,7 @@ Because a source breaking change is only harmful when developers recompile their
44
44
45
45
### Behavior breaking change
46
46
47
-
Behavior changes are the most common type of breaking change: almost any change in behavior could break someone. Changes to your library, such as method signatures, exceptions thrown or input or output data formats, could all negatively impact your library consumers. Even a bug fix can qualify as a breaking change if users relied on the previously broken behavior.
47
+
Behavior changes are the most common type of breaking change: almost any change in behavior could cause a logic error for a consumer. Changes to your library, such as method signatures, exceptions thrown or input or output data formats, could all negatively impact your library consumers. Even a bug fix can qualify as a breaking change if users relied on the previously broken behavior.
48
48
49
49
Adding features and improving bad behaviors is a good thing, but without care it can make it very hard for existing users to upgrade. One approach to helping developers deal with behavior breaking changes is to hide them behind settings. Settings let developers update to the latest version of your library while at the same time choosing to opt in or opt out of breaking changes. This strategy lets developers stay up to date while letting their consuming code adapt over time.
0 commit comments