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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants