Closes #20553

• Make invokable commands first-class citizen
• Move old command definition to a separate section

Pending docs to be updated:

• components/console/console_arguments.rst (full refactoring required)
• components/console/helpers/questionhelper.rst (full refactoring required)
• console/input.rst (full refactoring required)
• console.rst

I like the harmonization of some command names 👍

[OskarStark]

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

[yceruto]

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.

Thanks @alamirault and @OskarStark for your review 🙏

I’m actively looking for someone to help me refactor console.rst, as I’m running out of free-time before the final release.

Pending docs to be updated:

I would also add https://symfony.com/doc/current/console/input.html, wdyt @yceruto ?
I can help on this in a separate unitary PR if its ok

Thanks, Antoine! Sure, go for it.

Here we're discussing input related topics symfony/symfony#59602

Yonel, thanks a lot for this massive contribution 🙇

I agree with what you said here:

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

I'll wait a bit to read more opinions, but that's the plan I'd like to follow. Thanks!

I agree with doing the work in steps, but I think the order should be swapped around.

We can't update all examples across the documentation to use features that we didn't document properly in my opinion. This applies in particular to console/input.rst, which has to be updated before we can start using #[Option]/#[Argument] in the documentation.
But it would be perfectly fine if all articles in the docs still have outdated (too complex) examples, but the main guides are updated to document both the simple + advanced way.

We must also be careful about updating an example without updating the context it is placed in (I tried to comment on those cases whenever I saw this).

Thanks @wouterj, @94noni, and @javiereguiluz for your feedback! I will try to address it ASAP

FYI, console.rst file is ready for review.

Working on console/input.rst...

[alamirault]

execute is still in Lifecycle I think

Suggested change

	``__invoke()`` *(required)*
	``__invoke()`` and :method:`Symfony\\Component\\Console\\Command\\Command::execute` *(required)*

What do you think ?

[stof]

maybe with or instead of and

open to finish this PR @yceruto ? 🙏

No time to finish this soon :( sorry, looking for help to finish the remaining docs 🙏