From 515fbf88ca1f1fc6e9f410fb6b96dab9e8637832 Mon Sep 17 00:00:00 2001
From: Benjamin Gaussorgues <benjamin.gaussorgues@nextcloud.com>
Date: Mon, 29 Jun 2026 16:15:22 +0200
Subject: [PATCH 1/2] chore(jobs): write proper documentation for job:history

Signed-off-by: Benjamin Gaussorgues <benjamin.gaussorgues@nextcloud.com>
---
 core/Command/Background/JobsHistory.php | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/core/Command/Background/JobsHistory.php b/core/Command/Background/JobsHistory.php
index 566dfc550dd01..277b8c64122f9 100644
--- a/core/Command/Background/JobsHistory.php
+++ b/core/Command/Background/JobsHistory.php
@@ -33,10 +33,11 @@ protected function configure(): void {
 		parent::configure();
 
 		$help = <<<EOF
-			Display all currently running background jobs.
+			List historical job executions
 
-			You can find the following informations:
+			The output includes:
 			  - <info>Run ID:</info> job identifier as found in database (Snowflake ID)
+			  - <info>Status:</info> result of the job (Succeeded, Failed, Crashed)
 			  - <info>Class:</info> class of the job
 			  - <info>Started at:</info> start time of the job
 			  - <info>Server ID:</info> server ID as defined in <options=bold>config.php</> (see `serverid`). Highlighted if it’s running on current server.
@@ -48,7 +49,7 @@ protected function configure(): void {
 
 		$this
 			->setName('background-job:history')
-			->setDescription('Show currently running jobs')
+			->setDescription('List historical job executions')
 			->setHelp($help)
 			->addOption('limit', 'l', InputOption::VALUE_REQUIRED, 'Maximum number of results returned by the command', 200)
 			->addOption('class', 'c', InputOption::VALUE_IS_ARRAY | InputOption::VALUE_REQUIRED, 'Filter by class name', [])

From 4e588124a8230279021e78a03ccd9c9436d9c00f Mon Sep 17 00:00:00 2001
From: Benjamin Gaussorgues <benjamin.gaussorgues@nextcloud.com>
Date: Thu, 2 Jul 2026 13:57:55 +0200
Subject: [PATCH 2/2] chore(jobs): match documentation of job:history

Signed-off-by: Benjamin Gaussorgues <benjamin.gaussorgues@nextcloud.com>
---
 core/Command/Background/RunningJobs.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/core/Command/Background/RunningJobs.php b/core/Command/Background/RunningJobs.php
index 01c375eb306cc..e3ad3828a82ed 100644
--- a/core/Command/Background/RunningJobs.php
+++ b/core/Command/Background/RunningJobs.php
@@ -32,7 +32,7 @@ protected function configure(): void {
 		$help = <<<EOF
 			Display all currently running background jobs.
 
-			You can find the following informations:
+			The output includes:
 			  - <info>Run ID:</info> job identifier a found in database (Snowflake ID)
 			  - <info>Class:</info> class of the job
 			  - <info>Started at:</info> start time of the job