[FEATURE] Add attribute AsNonSchedulableCommand for "schedulable" (#6271)

* [FEATURE] Add attribute AsNonSchedulableCommand for "schedulable"

Resolves: TYPO3-Documentation/Changelog-To-Doc#1470
Releases: main

* [TASK] Language check

Releases: main

---------

Co-authored-by: Sarah McCarthy <[email protected]>

Author: linawolf

Documentation/ApiOverview/CommandControllers/CustomCommands.rst

@@ -99,42 +99,48 @@ definition of your class as a tag :yaml:`console.command`:
           - name: console.command
             command: 'examples:dosomething'
             description: 'A command that does nothing and always succeeds.'
+            // To hide it from the scheduler:
+            schedulable: false
           # Also an alias for the command can be configured
           - name: console.command
             command: 'examples:dosomethingalias'
             alias: true
 
 ..  note::
     Despite using :file:`autoconfigure: true` the commands
-    have to be explicitly defined in :file:`Configuration/Services.yaml`. It
-    is recommended to always supply a description, otherwise there will be
-    an empty space in the list of commands.
+    have to be explicitly defined in :file:`Configuration/Services.yaml` or
+    use the PHP attribute :php:`#[AsCommand]`.
 
 ..  _deactivating-the-command-in-scheduler:
 ..  _schedulable:
 
 Making a command non-schedulable
 ================================
 
-A command can be set as disabled for the scheduler by setting :yaml:`schedulable`
-to :yaml:`false`. This can only be done when registering the command via
-`tag <console-command-tutorial-registration-tag>`_ and not via attribute:
-
-
-..  code-block:: yaml
-    :caption: packages/my_extension/Configuration/Services.yaml
-
-    services:
-      # ...
+..  versionadded:: 14.0
+    The PHP attribute :php:`#[AsNonSchedulableCommand]` has been introduced to
+    mark a command as non-schedulable.
 
-      MyVendor\MyExtension\Command\DoSomethingCommand:
-        tags:
-          - name: console.command
-            command: 'examples:dosomething'
-            description: 'A command that does nothing and cannot be scheduled.'
-            schedulable: false
+    To provide support for both TYPO3 v14 and v13 continue to register your
+    command in :file:`Services.yaml` (see
+    `Tag console.command in the Services.yaml <https://docs.typo3.org/permalink/t3coreapi:console-command-tutorial-registration-tag>`_).
 
+A command can be set as disabled for the scheduler by using the
+:php:`#[AsNonSchedulableCommand]` attribute:
 
+..  code-block:: php
+    :caption: EXT:my_extension/Classes/Commands/MyImportCommand.php
+
+    use Symfony\Component\Console\Attribute\AsCommand;
+    use Symfony\Component\Console\Command\Command;
+    use TYPO3\CMS\Core\Attribute\AsNonSchedulableCommand;
+
+    #[AsCommand('myextension:import', 'Import data from external source')]
+    #[AsNonSchedulableCommand]
+    final class MyImportCommand extends Command
+    {
+        // ...
+    }
 
 ..  _writing-custom-symfony-console-command-context:
 

Documentation/ApiOverview/CommandControllers/Tutorial.rst

@@ -77,6 +77,9 @@ A command with parameters and arguments
 ..  literalinclude:: _Tutorial/_CreateWizardCommand.php
     :caption: packages/my_extension/Classes/Command/SendFluidMailCommand.php
 
+It uses attribute :php:`#[AsNonSchedulableCommand]` so that it can only be used
+from the console and not from the :guilabel:`Administration > Scheduler` module.
+
 This command takes one argument :php:`wizardName` (optional) and one option (optional),
 which can be added on the command line:
 
@@ -94,7 +97,6 @@ which can be added on the command line:
 
          typo3/sysext/core/bin/typo3 examples:createwizard [-b] [wizardName]
 
-
 ..  _console-command-tutorial-fluidmail:
 
 Sending a FluidMail via command

Documentation/ApiOverview/CommandControllers/_Tutorial/_CreateWizardCommand.php

@@ -12,10 +12,12 @@
 use Symfony\Component\Console\Output\OutputInterface;
 use Symfony\Component\Console\Style\SymfonyStyle;
 use T3docs\Examples\Exception\InvalidWizardException;
+use TYPO3\CMS\Core\Attribute\AsNonSchedulableCommand;
 
 #[AsCommand(
     name: 'myextension:createwizard',
 )]
+#[AsNonSchedulableCommand]
 final class CreateWizardCommand extends Command
 {
     protected function configure(): void