From f5b1f23b7bec02a309780d47378645eec5a2a33a Mon Sep 17 00:00:00 2001
From: "Alexander M. Turek" <me@derrabus.de>
Date: Sat, 8 Apr 2017 11:24:10 +0200
Subject: [PATCH] Documented short DI tag syntax.

---
 service_container/tags.rst | 29 +++++++++++++++++++++++------
 1 file changed, 23 insertions(+), 6 deletions(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index 75bd17607ec..34e2145853b 100644
--- 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::