Skip to content

chore(jobs): write proper documentation for job:history#61657

Open
Altahrim wants to merge 1 commit into
masterfrom
chore/bg_jobs_help
Open

chore(jobs): write proper documentation for job:history#61657
Altahrim wants to merge 1 commit into
masterfrom
chore/bg_jobs_help

Conversation

@Altahrim

Copy link
Copy Markdown
Collaborator

Summary

Remove copy-paste…

Checklist

AI (if applicable)

  • The content of this PR was partly or fully generated using AI
Signed-off-by: Benjamin Gaussorgues <benjamin.gaussorgues@nextcloud.com>
@Altahrim Altahrim added this to the Nextcloud 35 milestone Jun 29, 2026
@Altahrim Altahrim self-assigned this Jun 29, 2026
@Altahrim Altahrim requested a review from a team as a code owner June 29, 2026 14:17
@Altahrim Altahrim requested review from icewind1991, leftybournes, nfebe and sorbaugh and removed request for a team June 29, 2026 14:17
@Altahrim Altahrim added the 3. to review Waiting for reviews label Jun 29, 2026
@Altahrim

Copy link
Copy Markdown
Collaborator Author

/backport to stable34 please

Display all currently running background jobs.
List jobs previously executed by Nextcloud

You can find the following informations:

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
You can find the following informations:
You can find the following information:

Or even shorter:

Suggested change
You can find the following informations:
The output includes:

$help = <<<EOF
Display all currently running background jobs.
List jobs previously executed by Nextcloud

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit:

Suggested change
List jobs previously executed by Nextcloud
List previously executed Nextcloud jobs

(reads a bit more natural)

Or even:

Suggested change
List jobs previously executed by Nextcloud
List historical job executions

(shorter + wording matches command)

$this
->setName('background-job:history')
->setDescription('Show currently running jobs')
->setDescription('List previous job executions')

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit / just ideas:

Suggested change
->setDescription('List previous job executions')
->setDescription('List historical job executions')
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

3 participants