Merge branch '3.4' into 4.4

* 3.4:
  Shortening the next paragraph
  Removing redundant info

Author: javiereguiluz

form/form_collections.rst

@@ -19,8 +19,7 @@ that Task, right inside the same form.
     including the ``ManyToMany`` association mapping definition on the Task's
     ``tags`` property.
 
-First, suppose that each ``Task`` belongs to multiple ``Tag`` objects. Start
-by creating a simple ``Task`` class::
+Let's start by creating a ``Task`` entity::
 
     // src/Entity/Task.php
     namespace App\Entity;
@@ -30,7 +29,6 @@ by creating a simple ``Task`` class::
     class Task
     {
         protected $description;
-
         protected $tags;
 
         public function __construct()
@@ -159,8 +157,8 @@ In your controller, you'll create a new form from the ``TaskType``::
         {
             $task = new Task();
 
-            // dummy code - this is here just so that the Task has some tags
-            // otherwise, this isn't an interesting example
+            // dummy code - add some example tags to the task
+            // (otherwise, the template will render an empty list of tags)
             $tag1 = new Tag();
             $tag1->setName('tag1');
             $task->getTags()->add($tag1);
@@ -174,7 +172,7 @@ In your controller, you'll create a new form from the ``TaskType``::
             $form->handleRequest($request);
 
             if ($form->isSubmitted() && $form->isValid()) {
-                // ... maybe do some form processing, like saving the Task and Tag objects
+                // ... do your form processing, like saving the Task and Tag entities
             }
 
             return $this->render('task/new.html.twig', [
@@ -183,11 +181,8 @@ In your controller, you'll create a new form from the ``TaskType``::
         }
     }
 
-The corresponding template is now able to render both the ``description``
-field for the task form as well as all the ``TagType`` forms for any tags
-that are already related to this ``Task``. In the above controller, I added
-some dummy code so that you can see this in action (since a ``Task`` has
-zero tags when first created).
+In the template, you can now iterate over the existing ``TagType`` forms
+to render them:
 
 .. code-block:: html+twig
 
@@ -196,12 +191,10 @@ zero tags when first created).
     {# ... #}
 
     {{ form_start(form) }}
-        {# render the task's only field: description #}
         {{ form_row(form.description) }}
 
         <h3>Tags</h3>
         <ul class="tags">
-            {# iterate over each existing tag and render its only field: name #}
             {% for tag in form.tags %}
                 <li>{{ form_row(tag.name) }}</li>
             {% endfor %}