[Console] Commands auto-registration is deprecated

Author: GuilhemN

console.rst

@@ -12,11 +12,11 @@ use it to create your own commands.
 Creating a Command
 ------------------
 
-Commands are defined in classes which must be created in the ``Command`` namespace
-of your bundle (e.g. ``AppBundle\Command``) and their names must end with the
+Commands are defined in classes which should be created in the ``Command`` namespace
+of your bundle (e.g. ``AppBundle\Command``) and their names should end with the
 ``Command`` suffix.
 
-For example, a command called ``CreateUser`` must follow this structure::
+For example, you may want a command to create an user::
 
     // src/AppBundle/Command/CreateUserCommand.php
     namespace AppBundle\Command;
@@ -38,6 +38,19 @@ For example, a command called ``CreateUser`` must follow this structure::
         }
     }
 
+If you're using the :ref:`default services.yml configuration <service-container-services-load-example>`,
+your command classes are automatically registered as services. You have nothing
+else to do!
+
+.. note::
+
+    You can also manually register your command as a service by configuring the service
+    and :doc:`tagging it </service_container/tags>` with ``console.command``.
+
+    Symfony also looks in the ``Command/`` directory of bundles for commands
+    non registered as a service but this is deprecated since Symfony 3.4 and
+    won't be supported in Symfony 4.0.
+
 Configuring the Command
 -----------------------
 

console/commands_as_services.rst

@@ -5,9 +5,13 @@ How to Define Commands as Services
 ==================================
 
 If you're using the :ref:`default services.yml configuration <service-container-services-load-example>`,
-your command classes are already registered as services. Great! This is the recommended
-setup, but it's not required. Symfony also looks in the ``Command/`` directory of
-each bundle and automatically registers those classes as commands.
+your command classes are already registered as services. Great! This is the
+recommended setup.
+
+Symfony also looks in the ``Command/`` directory of each bundle for commands
+non registered as a service and automatically registers those classes as
+commands. However this auto-registration was deprecated in Symfony 3.4. In
+Symfony 4.0, commands won't be auto-registered anymore.
 
 .. note::