From b990c615ce3c33a65db1682c9919ca3553768ca5 Mon Sep 17 00:00:00 2001
From: Jannik Zschiesche <j.zschiesche@21torr.com>
Date: Fri, 7 Nov 2025 12:11:20 +0100
Subject: [PATCH] Add docs for DispatchAfterRunTask

---
 blog/2025-11-07-task-manager-redispatch.mdx |  9 +++++
 docs/php/symfony/task-manager/index.mdx     | 40 ++++++++++++++++++++-
 2 files changed, 48 insertions(+), 1 deletion(-)
 create mode 100644 blog/2025-11-07-task-manager-redispatch.mdx

diff --git a/blog/2025-11-07-task-manager-redispatch.mdx b/blog/2025-11-07-task-manager-redispatch.mdx
new file mode 100644
index 0000000..d473563
--- /dev/null
+++ b/blog/2025-11-07-task-manager-redispatch.mdx
@@ -0,0 +1,9 @@
+---
+title: "Task Manager: DispatchAfterRunTask"
+authors: [jannik]
+tags: [task-manager]
+---
+
+The task manager is now able [to redispatch messages], that should be used in the Scheduler, for example.
+
+[to redispatch messages]: /docs/php/symfony/task-manager/#queueing-tasks-after-the-current-run
diff --git a/docs/php/symfony/task-manager/index.mdx b/docs/php/symfony/task-manager/index.mdx
index 89f3319..6c97158 100644
--- a/docs/php/symfony/task-manager/index.mdx
+++ b/docs/php/symfony/task-manager/index.mdx
@@ -192,6 +192,44 @@ bin/console task-manager:queue task-id-1 task-id-2
 ```
 
 
+### Queueing Tasks After the Current Run
+
+You can also queue tasks after the current run. This is handy when dispatching tasks in a scheduler. The scheduler
+starts working on these tasks right away, but in nearly all cases you want to have these tasks in their regular queues, to be able
+to use the priority system.
+
+```php
+use Symfony\Component\Scheduler\Attribute\AsSchedule;
+use Symfony\Component\Scheduler\ScheduleProviderInterface;
+use Symfony\Component\Scheduler\Schedule;
+use Torr\TaskManager\Task\DispatchAfterRunTask\DispatchAfterRunTask;
+
+#[AsSchedule]
+class AppSchedule implements ScheduleProviderInterface
+{
+	public function getSchedule() : Schedule
+	{
+		return new Schedule()
+			// ...
+			->add(RecurringMessage::cron(
+				"*/5 * * * *",
+				// we want to redispatch the task in the scheduler
+				new DispatchAfterRunTask(
+					new DownloadExternalFilesTask(),
+				),
+			));
+	}
+}
+```
+
+
+:::warning
+Symfony has a similar feature with the [`RedispatchMessage`], however in their implementation you need to explicitly specify the queue the task should go into (otherwise it will get dropped).
+
+We want to keep using the default queue, so we have our own task for that.
+:::
+
+
 ## Task Handlers
 
 As this bundle builds on top of Symfony messages, you define your task handler as message handler:
@@ -288,4 +326,4 @@ bin/console task-manager:debug
 [Supervisor]: https://symfony.com/doc/current/messenger.html#supervisor-configuration
 [Symfony Messenger]: https://symfony.com/doc/current/messenger.html
 [systemd]: https://symfony.com/doc/current/messenger.html#systemd-configuration
-
+[`RedispatchMessage`]: https://symfony.com/doc/current/messenger.html#redispatching-a-message