From 84e17b0e0967b6e7eb6ef5b2175d1fbd68335b0b Mon Sep 17 00:00:00 2001
From: kenjis <kenji.uui@gmail.com>
Date: Thu, 6 Jan 2022 09:40:54 +0900
Subject: [PATCH] docs: add upgrade instruction when validating an array
 without `*`

---
 user_guide_src/source/installation/upgrade_416.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/user_guide_src/source/installation/upgrade_416.rst b/user_guide_src/source/installation/upgrade_416.rst
index 36f0d1039b46..ce88d59582b7 100644
--- a/user_guide_src/source/installation/upgrade_416.rst
+++ b/user_guide_src/source/installation/upgrade_416.rst
@@ -20,6 +20,17 @@ Validation result changes
 
 Due to a bug fix, the Validation now might change the validation results when you validate an array item (see :ref:`Changelog <changelog-v416-validation-changes>`). So check the validation results for all the code that validates the array. Validating multiple fields like ``contacts.*.name`` is not affected.
 
+If you have the following form::
+
+    <input type='text' name='invoice_rule[1]'>
+    <input type='text' name='invoice_rule[2]'>
+
+And you have the validation rule like this::
+
+    'invoice_rule' =>  ['rules' => 'numeric', 'errors' => ['numeric' => 'Not numeric']]
+
+Change the rule key to ``invoice_rule.*`` and the validation will work.
+
 Breaking Enhancements
 *********************