minor #12046 [Form] Mention that by_reference only works in English (javiereguiluz)

OskarStark · OskarStark · commit 3cd34b125722 · 2019-07-30T08:43:35.000+02:00
This PR was merged into the 3.4 branch. Discussion ---------- [Form] Mention that by_reference only works in English Fixes #6681. Commits ------- f81f76c [Form] Mention that by_reference only works in English
diff --git a/form/form_collections.rst b/form/form_collections.rst
@@ -445,6 +445,12 @@ you will learn about next!).
     otherwise the form will still use ``setTag()`` even if ``by_reference`` is ``false``.
     You'll learn more about the ``removeTag()`` method later in this article.
 
+.. caution::
+
+    Symfony can only make the plural-to-singular conversion (e.g. from the
+    ``tags`` property to the ``addTag()`` method) for English words. Code
+    written in any other language won't work as expected.
+
 .. sidebar:: Doctrine: Cascading Relations and saving the "Inverse" side
 
     To save the new tags with Doctrine, you need to consider a couple more
