Merge pull request #2428 from joelclermont/issue_1566

add notes on collection and entity field types

Author: weaverryan

reference/forms/types/collection.rst

@@ -29,6 +29,13 @@ forms, which is useful when creating forms that expose one-to-many relationships
 | Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\CollectionType`    |
 +-------------+-----------------------------------------------------------------------------+
 
+.. note::
+
+    If you are working with a collection of Doctrine entities, pay special 
+    attention to the `allow_add`_, `allow_delete`_ and `by_reference`_ options.
+    You can also see a complete example in the cookbook article 
+    :doc:`/cookbook/form/form_collections`.
+
 Basic Usage
 -----------
 

reference/forms/types/entity.rst

@@ -115,6 +115,13 @@ These options inherit from the :doc:`choice</reference/forms/types/choice>` type
 
 .. include:: /reference/forms/types/options/multiple.rst.inc
 
+.. note::
+    
+    If you are working with a collection of Doctrine entities, it will be helpful
+    to read the documention for the :doc:`/reference/forms/types/collection`
+    as well. In addition, there is a complete example in the cookbook article
+    :doc:`/cookbook/form/form_collections`.
+    
 .. include:: /reference/forms/types/options/expanded.rst.inc
 
 .. include:: /reference/forms/types/options/preferred_choices.rst.inc