Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

DOCSP-39849: revise job batching docs #2994

Merged
merged 4 commits into from
Jun 20, 2024

Conversation

rustagir
Copy link
Contributor

@rustagir rustagir commented Jun 4, 2024

https://jira.mongodb.org/browse/DOCSP-39849
Revises docs changes made in #2904

STAGING

Checklist

  • Add tests and ensure they pass
  • Add an entry to the CHANGELOG.md file
  • Update documentation for new features

@rustagir rustagir requested a review from a team as a code owner June 4, 2024 15:23
@rustagir rustagir changed the base branch from 4.5 to 4.4 June 4, 2024 15:23
@github-actions github-actions bot added the docs label Jun 4, 2024
docs/queues.txt Outdated
Comment on lines 24 to 26
'collection' => 'jobs',
'queue' => 'default',
'retry_after' => 60,
Copy link
Member

Choose a reason for hiding this comment

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

In #2985 (comment) we decided with @jmikola to comment optional settings.

Suggested change
'collection' => 'jobs',
'queue' => 'default',
'retry_after' => 60,
// 'collection' => 'jobs',
// 'queue' => 'default',
// 'retry_after' => 60,

docs/queues.txt Outdated
@@ -35,22 +38,29 @@ the driver in ``config/queue.php``:
- Description

* - ``driver``
- **Required**. Specifies the queue driver to use. Must be ``mongodb``.
- **Required**. Specifies the queue driver to use. The value of
Copy link
Member

Choose a reason for hiding this comment

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

I find it cumbersome to repeat "Specifies" for every setting.

docs/queues.txt Outdated Show resolved Hide resolved
@GromNaN GromNaN requested review from GromNaN and removed request for GromNaN June 4, 2024 17:10
GromNaN

This comment was marked as resolved.

@rustagir rustagir requested a review from GromNaN June 4, 2024 18:21
Copy link
Contributor

@norareidy norareidy left a comment

Choose a reason for hiding this comment

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

LGTM with minor comments!

docs/queues.txt Outdated Show resolved Hide resolved
docs/queues.txt Outdated Show resolved Hide resolved
docs/queues.txt Outdated Show resolved Hide resolved
docs/queues.txt Outdated
Comment on lines 25 to 27
// 'collection' => 'jobs',
// 'queue' => 'default',
// 'retry_after' => 60,
Copy link
Contributor

Choose a reason for hiding this comment

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

S: It's a little unclear why these fields are commented out - are they optional? I think either leaving them uncommented and highlighting line 24 or deleting them altogether would be better

Copy link
Contributor

Choose a reason for hiding this comment

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

Based on the table below, collection and queue are required so maybe leaving uncommented and highlighting line 24 is the way to go

@rustagir rustagir merged commit 512c610 into mongodb:4.4 Jun 20, 2024
26 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants