Add migration guide

Include notes for cakephp/cakephp#17947
cakephp · Oct 7, 2024 · 249f017 · 249f017
1 parent 70892fa
commit 249f017
Show file tree

Hide file tree

Showing 2 changed files with 15 additions and 0 deletions.
diff --git a/en/appendices/5-2-migration-guide.rst b/en/appendices/5-2-migration-guide.rst
@@ -0,0 +1,14 @@
+5.2 Migration Guide
+###################
+
+The 5.2.0 release is a backwards compatible with 5.0. It adds new functionality
+and introduces new deprecations. Any functionality deprecated in 5.x will be
+removed in 6.0.0.
+
+Behavior Changes
+================
+
+- ``ValidationSet::add()`` will now raise errors when a rule is added with
+  a name that is already defined. This change aims to prevent rules from being
+  overwritten by accident.
+
diff --git a/en/appendices/migration-guides.rst b/en/appendices/migration-guides.rst
@@ -10,4 +10,5 @@ each version and the migration path between 5.x minor releases.
     ./5-0-upgrade-guide
     ./5-0-migration-guide
     ./5-1-migration-guide
+    ./5-2-migration-guide
     ./phpunit10