feature #7834 Added a note about ignoring invalid reference arguments in collection arguments (javiereguiluz)

This PR was submitted for the 3.1 branch but it was merged into the 3.2 branch instead (closes #7834).

Discussion
----------

Added a note about ignoring invalid reference arguments in collection arguments

This fixes #6550.

Commits
-------

0b2d9ba Added a note about ignoring invalid reference arguments in colleciton arguments

Author: xabbuh

service_container/optional_dependencies.rst

@@ -116,6 +116,12 @@ call if the service exists and remove the method call if it does not:
             ))
         ;
 
+.. note::
+
+    If the argument to the method call is a collection of arguments and any of
+    them is missing, those elements are removed but the method call is still
+    made with the remaining elements of the collection.
+
 In YAML, the special ``@?`` syntax tells the service container that the dependency
 is optional. Of course, the ``NewsletterManager`` must also be rewritten by
 adding a ``setMailer()`` method::