Document the ability to set aliases and hidden status via command name

- Add documentation for the pipe syntax to define command aliases
- Document how to make commands hidden using the `|` prefix
- Show examples for both #[AsCommand] attribute and constructor usage
- Include version annotation for Symfony 7.4

Author: OskarStark

console.rst

@@ -240,6 +240,60 @@ You can register the command by adding the ``AsCommand`` attribute to it::
         // ...
     }
 
+.. versionadded:: 7.4
+
+    The ability to define aliases and hidden status through the command name was introduced in Symfony 7.4.
+
+You can also define aliases and hidden status directly in the command name using
+a pipe (``|``) separator::
+
+    // src/Command/CreateUserCommand.php
+    namespace App\Command;
+
+    use Symfony\Component\Console\Attribute\AsCommand;
+    use Symfony\Component\Console\Command\Command;
+
+    // Define a command with aliases
+    #[AsCommand(
+        name: 'app:create-user|app:add-user|app:new-user',
+        description: 'Creates a new user.',
+    )]
+    class CreateUserCommand extends Command
+    {
+        // ...
+    }
+
+    // Define a hidden command
+    #[AsCommand(
+        name: '|app:create-user',
+        description: 'Creates a new user.',
+    )]
+    class CreateUserCommand extends Command
+    {
+        // ...
+    }
+
+When using the pipe syntax:
+
+- The first name in the list defines the command name, the others are aliases
+- When the first name is empty (starts with ``|``), the command is marked as hidden
+
+This syntax also works when passing the name to the parent constructor::
+
+    class CreateUserCommand extends Command
+    {
+        public function __construct()
+        {
+            // Define command with aliases
+            parent::__construct('app:create-user|app:add-user');
+            
+            // Or define a hidden command
+            // parent::__construct('|app:create-user');
+        }
+        
+        // ...
+    }
+
 If you can't use PHP attributes, register the command as a service and
 :doc:`tag it </service_container/tags>` with the ``console.command`` tag. If you're using the
 :ref:`default services.yaml configuration <service-container-services-load-example>`,

console/hide_commands.rst

@@ -23,6 +23,36 @@ the ``hidden`` property of the ``AsCommand`` attribute::
         // ...
     }
 
+.. versionadded:: 7.4
+
+    The ability to define a command as hidden using the pipe syntax in the command name was introduced in Symfony 7.4.
+
+You can also define a command as hidden using the pipe (``|``) syntax in the command name::
+
+    // src/Command/LegacyCommand.php
+    namespace App\Command;
+
+    use Symfony\Component\Console\Attribute\AsCommand;
+    use Symfony\Component\Console\Command\Command;
+
+    #[AsCommand(name: '|app:legacy')]
+    class LegacyCommand extends Command
+    {
+        // ...
+    }
+
+This syntax also works when passing the name to the parent constructor::
+
+    class LegacyCommand extends Command
+    {
+        public function __construct()
+        {
+            parent::__construct('|app:legacy');
+        }
+        
+        // ...
+    }
+
 Hidden commands behave the same as normal commands but they are no longer displayed
 in command listings, so end-users are not aware of their existence.