feature #7769 Documented short DI tag syntax (derrabus)

xabbuh · xabbuh · commit 78493319e2b1 · 2017-04-08T12:24:14.000+02:00
This PR was merged into the master branch. Discussion ---------- Documented short DI tag syntax This PR fixes #7248 and documents the short DI tag syntax for YAML files. Commits ------- f5b1f23 Documented short DI tag syntax.
diff --git a/service_container/tags.rst b/service_container/tags.rst
@@ -19,8 +19,7 @@ to be used for a specific purpose. Take the following example:
             app.twig_extension:
                 class: AppBundle\Twig\AppExtension
                 public: false
-                tags:
-                    - { name: twig.extension }
+                tags: [twig.extension]
 
     .. code-block:: xml
 
@@ -148,13 +147,11 @@ For example, you may add the following transports as services:
             app.smtp_transport:
                 class: \Swift_SmtpTransport
                 arguments: ['%mailer_host%']
-                tags:
-                    - { name: app.mail_transport }
+                tags: [app.mail_transport]
 
             app.sendmail_transport:
                 class: \Swift_SendmailTransport
-                tags:
-                    - { name: app.mail_transport }
+                tags: [app.mail_transport]
 
     .. code-block:: xml
 
@@ -341,6 +338,26 @@ To answer this, change the service declaration:
         $definitionSendmail->addTag('app.mail_transport', array('alias' => 'bar'));
         $container->setDefinition('app.sendmail_transport', $definitionSendmail);
 
+.. tip::
+
+    In YAML format, you may provide the tag as a simple string as long as you don't need to specify additional
+    attributes. The following definitions are equivalent.
+
+    .. code-block:: yaml
+
+        services:
+
+            # Compact syntax
+            app.sendmail_transport:
+                class: \Swift_SendmailTransport
+                tags: [app.mail_transport]
+
+            # Verbose syntax
+            app.sendmail_transport:
+                class: \Swift_SendmailTransport
+                tags:
+                    - { name: app.mail_transport }
+
 Notice that you've added a generic ``alias`` key to the tag. To actually
 use this, update the compiler::
 
