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

- Add separate documentation sections for command aliases and hidden commands
- Document 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 separate version annotations for Symfony 7.4 for each feature

Author: OskarStark

console.rst

@@ -240,6 +240,75 @@ You can register the command by adding the ``AsCommand`` attribute to it::
         // ...
     }
 
+You can also define aliases 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;
+
+    #[AsCommand(
+        name: 'app:create-user|app:add-user|app:new-user',
+        description: 'Creates a new user.',
+    )]
+    class CreateUserCommand extends Command
+    {
+        // ...
+    }
+
+.. versionadded:: 7.4
+
+    The ability to define aliases through the command name was introduced in Symfony 7.4.
+
+When using the pipe syntax, the first name in the list defines the command name, 
+the others are aliases. This syntax also works when passing the name to the parent 
+constructor::
+
+    class CreateUserCommand extends Command
+    {
+        public function __construct()
+        {
+            parent::__construct('app:create-user|app:add-user');
+        }
+        
+        // ...
+    }
+
+To create a hidden command, start the name with a pipe (``|``)::
+
+    // src/Command/CreateUserCommand.php
+    namespace App\Command;
+
+    use Symfony\Component\Console\Attribute\AsCommand;
+    use Symfony\Component\Console\Command\Command;
+
+    #[AsCommand(
+        name: '|app:create-user',
+        description: 'Creates a new user.',
+    )]
+    class CreateUserCommand extends Command
+    {
+        // ...
+    }
+
+.. versionadded:: 7.4
+
+    The ability to define hidden commands through the command name was introduced in Symfony 7.4.
+
+When the first name is empty (starts with ``|``), the command is marked as hidden. 
+This also works in the constructor::
+
+    class CreateUserCommand extends Command
+    {
+        public function __construct()
+        {
+            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,24 @@ the ``hidden`` property of the ``AsCommand`` attribute::
         // ...
     }
 
+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
+    {
+        // ...
+    }
+
+.. 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.
+
 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.