Merge pull request #7832 from cakephp/rules-remove

Add docs for cakephp/cakephp#17634

Author: ADmad

en/appendices/5-1-migration-guide.rst

@@ -64,6 +64,13 @@ Core
   a typesafe way to cast request data or other input and return ``null`` when conversion fails.
 - ``pathCombine()`` was added to help build paths without worrying about duplicate and trailing slashes.
 
+Datasource
+----------
+
+- ``RulesChecker::remove()``, ``removeCreate()``, ``removeUpdate()``, and
+  ``removeDelete()`` methods were added. These methods allow you to remove rules
+  by name.
+
 Http
 ----
 

en/orm/validation.rst

@@ -742,3 +742,22 @@ The same result can be expected when using ``newEntity()`` or
 
     $userEntity = $usersTable->newEntity(['email' => 'not an email!!']);
     $userEntity->getError('email'); // Invalid email
+
+Removing Rules
+--------------
+
+If you need to remove rules from a ``RulesChecker`` use a remove method::
+
+    // Remove a general rule by name
+    $rules->remove('ruleName');
+
+    // Remove a create rule
+    $rules->removeCreate('ruleName');
+
+    // Remove an update rule
+    $rules->removeUpdate('ruleName');
+
+    // Remove a delete rule
+    $rules->removeDelete('ruleName');
+
+.. versionadded:: 5.1.0