diff --git a/Neos.ContentRepository.Core/Classes/CommandHandler/Commands.php b/Neos.ContentRepository.Core/Classes/CommandHandler/Commands.php
index c76eb1955e..85cee65f83 100644
--- a/Neos.ContentRepository.Core/Classes/CommandHandler/Commands.php
+++ b/Neos.ContentRepository.Core/Classes/CommandHandler/Commands.php
@@ -4,6 +4,8 @@
 
 namespace Neos\ContentRepository\Core\CommandHandler;
 
+use Neos\ContentRepository\Core\Subscription\Exception\CatchUpHadErrors;
+
 /**
  * @api can be used as collection of commands to be individually handled:
  *
@@ -11,6 +13,9 @@
  *         $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