TASK: Explain behaviour when handling multiple commands

neos · Dec 7, 2024 · 21318b2 · 21318b2
1 parent 4c41482
commit 21318b2
Showing 1 changed file with 5 additions and 0 deletions.
diff --git a/Neos.ContentRepository.Core/Classes/CommandHandler/Commands.php b/Neos.ContentRepository.Core/Classes/CommandHandler/Commands.php
@@ -4,13 +4,18 @@
 
 namespace Neos\ContentRepository\Core\CommandHandler;
 
+use Neos\ContentRepository\Core\Subscription\Exception\CatchUpHadErrors;
+
 /**
  * @api can be used as collection of commands to be individually handled:
  *
  *     foreach ($commands as $command) {
  *         $contentRepository->handle($command);
  *     }
  *
+ * Note that as they are separate commands, they might individually fail due to constraints
+ * or a projection or catchup failing during the first catchup with {@see CatchUpHadErrors}
+ *
  * @implements \IteratorAggregate<CommandInterface>
  */
 final readonly class Commands implements \IteratorAggregate, \Countable