minor #7376 Added a tip about the expanded YAML syntax (javiereguiluz)

xabbuh · xabbuh · commit 9e78259ff0da · 2017-01-31T22:12:09.000+01:00
This PR was squashed before being merged into the 2.7 branch (closes #7376). Discussion ---------- Added a tip about the expanded YAML syntax This fixes #5107. Commits ------- a5ea7b1 Added a tip about the expanded YAML syntax
diff --git a/service_container.rst b/service_container.rst
@@ -456,6 +456,29 @@ Injecting the dependency by the setter method just needs a change of syntax:
     and "setter injection". The Symfony service container also supports
     "property injection".
 
+.. tip::
+
+    The YAML configuration files support an expanded syntax which may be useful
+    when the YAML contents are long and complex:
+
+    .. code-block:: yaml
+
+        # app/config/services.yml
+        services:
+            # traditional syntax
+            app.newsletter_manager:
+                class: AppBundle\Newsletter\NewsletterManager
+                calls:
+                    - [setMailer, ['@app.mailer']]
+
+            # expanded syntax
+            app.newsletter_manager:
+                class: AppBundle\Newsletter\NewsletterManager
+                calls:
+                    - method: setMailer
+                      arguments:
+                          - '@app.mailer'
+
 Learn more
 ----------
 
