Rewords and tweaks

Author: javiereguiluz

console.rst

@@ -80,26 +80,36 @@ You can optionally define a description, help message and the
 :doc:`input options and arguments </console/input>`::
 
     // ...
-    // the short description shown while running "php bin/console list"
+    // the command description shown when running "php bin/console list"
     protected static $defaultDescription = 'Creates a new user.';
 
     // ...
     protected function configure(): void
     {
         $this
-            ->setDescription(self::$defaultDescription)
+            // If you don't like using the $defaultDescription static property,
+            // you can also define the short description using this method:
+            // ->setDescription('...')
 
-            // the full command description shown when running the command with
-            // the "--help" option
+            // the command help shown when running the command with the "--help" option
             ->setHelp('This command allows you to create a user...')
         ;
     }
 
+Defining the ``$defaultDescription`` static property instead of using the
+``setDescription()`` method allows to get the command description without
+instantiating its class. This makes the ``php bin/console list`` command run
+much faster.
+
+If you want to always run the ``list`` command fast, add the ``--short`` option
+to it (``php bin/console list --short``). This will avoid instantiating command
+classes, but it won't show any description for commands that use the
+``setDescription()`` method instead of the static property.
+
 .. versionadded:: 5.3
 
-    The ``$defaultDescription`` static property was introduced in Symfony 5.3.
-    It allows to make the ``php bin/console list`` lazy.
-    You can as well use ``php bin/console list --short`` option to have the output faster.
+    The ``$defaultDescription`` static property and the ``--short`` option
+    were introduced in Symfony 5.3.
 
 The ``configure()`` method is called automatically at the end of the command
 constructor. If your command defines its own constructor, set the properties