feature #5023 Added a note about data transformers not being applied …

…with inherit_data option set (javiereguiluz)

This PR was merged into the 2.3 branch.

Discussion
----------

Added a note about data transformers not being applied with inherit_data option set

| Q             | A
| ------------- | ---
| Doc fix?      | no
| New docs?     | yes
| Applies to    | 2.3+
| Fixed tickets | #4332

Commits
-------

ca21fb6 Removed a wrong link to a included file
3e90336 Fixed an internal link
2bd8cf3 Added a note about data transformers not being applied with inherit_data option set

cookbook/form/data_transformers.rst

@@ -17,6 +17,11 @@ You could try to do this in your controller, but it's not the best solution.
 It would be better if this issue were automatically converted to an Issue object.
 This is where Data Transformers come into play.
 
+.. caution::
+
+    When a form field has the ``inherit_data`` option set, Data Transformers
+    won't be applied to that field.
+
 Creating the Transformer
 ------------------------
 

reference/forms/types/options/inherit_data.rst.inc

@@ -10,3 +10,9 @@ inherit_data
 This option determines if the form will inherit data from its parent form.
 This can be useful if you have a set of fields that are duplicated across
 multiple forms. See :doc:`/cookbook/form/inherit_data_option`.
+
+.. caution::
+
+    When a field has the ``inherit_data`` option set, it uses the data of the
+    parent form as is. This means that :doc:`Data Transformers </cookbook/form/data_transformers>`
+    won't be applied to that field.