DRIVERS-2024 BC behavior breaks and semver mantra

mongodb · Feb 8, 2022 · 71c67c0 · 71c67c0
1 parent 2d52481
commit 71c67c0
Showing 1 changed file with 8 additions and 0 deletions.
diff --git a/README.rst b/README.rst
@@ -94,6 +94,14 @@ Drivers follow semantic versioning
 Drivers should follow X.Y.Z versioning, where breaking API changes require a
 bump to X.  See `semver.org <https://semver.org/>`_  for more.
 
+Backward breaking behavior changes and semver
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Backward breaking behavior changes can be more dangerous and disruptive than
+backward breaking API changes. When thinking about the implications of a
+behavior change, ask yourself what could happen if a user upgraded your library
+without carefully reading the changelog and/or adequately testing the change.
+
 Writing Documents
 -----------------