maybe we should make all these changes with the #AsCommand attribute in a separate PR to avoid growing this PR?

I’d actually prefer to keep all these related changes in a single PR, since they’re closely tied together. It helps keep the context in one place and makes it easier to review everything as a whole.

In any case, we can go ahead and merge this one, then open a new PR for the remaining updates.

This whole section needs updating, the text currently no longer matches the updated code example.

I think we can remove it completely, and instead merge it with the previous section. Something like

You can also use ``#[AsCommand]`` to add a description and longer help text for the command::

    // src/Command/CreateUserCommand.php

    #[AsCommand(
        name: 'app:create-user',
        description: 'Creates a new user.', // the command description shown when running "php bin/console list"
        help: 'This command allows you to create a user...', // the command help shown when running the command with the "--help" option
    )]
    class CreateUserCommand
    {
        public function __invoke(): int
        {
            // ...
        }
    }

Additionally, you can extend the :class:`Symfony\\Component\\Console\\Command\\Command`
class to leverage advanced features like lifecycle hooks (e.g.
:method:`Symfony\\Component\\Console\\Command\\Command::initialize`,
:method:`Symfony\\Component\\Console\\Command\\Command::interact`) and built-in
helpers.

The next section ("Registering the Command") also needs rework, the document now only shows the #[AsCommand] examples, so "You can register the command by adding the AsCommand attribute to it:" is out of place now.

However, we need to document the final paragraph ("If you can't use PHP attributes, register the command as a service [...]") somewhere in this article I think.

This PR doesn't update https://symfony.com/doc/current/console/input.html (not sure if that is intentional). This means that we never documented #[Argument] or #[Option].

I don't think it's a good idea to update other examples with these attributes as long as we don't document the attributes themselves.

I agree. input.rst is one of the pending documents to update.