-
Notifications
You must be signed in to change notification settings - Fork 2k
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
[gh-24311] Expand on documentation about jobs that are both parameterised and periodic #24384
Conversation
5489ef8
to
e57bbf4
Compare
782140c
to
e467896
Compare
e467896
to
4095fc5
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
looks really good! just a few comments to consider :)
ID Type Submit Date | ||
sync batch/periodic/parameterized 2024-11-07T10:43:30+01:00 // Original submitted job | ||
sync/dispatch-1730972650-247c6e97 batch/periodic 2024-11-07T10:44:10+01:00 // First dispatched job with parameters A | ||
sync/dispatch-1730972650-247c6e97/periodic-1730972680 batch 2024-11-07T10:44:40+01:00 // Cron job with parameters A |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
whoa! I didn't notice these great // comments
in the preview, because I didn't see that the little code block could scroll to the right; I only saw to the Type
column. I'm not sure what to suggest for that... maybe say above this to "Scroll to the right for descriptions of each job."?
See the [parameterized] documentation for additional considerations when | ||
using in conjunction with parameterized options. | ||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
this seems a little buried under these Parameters. maybe move it up under Requirements?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Since this periodic page doesn't talk about parameterized options at all, what about moving this line right before the #
periodic Requirements
section?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
It is a bit of a corner case, I didn't want to put it in the general description
Co-authored-by: Aimee Ukasick <[email protected]>
Co-authored-by: Aimee Ukasick <[email protected]>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks for the changes! A few more suggestions.
Co-authored-by: Aimee Ukasick <[email protected]>
Co-authored-by: Aimee Ukasick <[email protected]>
Co-authored-by: Aimee Ukasick <[email protected]>
Co-authored-by: Aimee Ukasick <[email protected]>
Addresses this issue.
Deploy preview: https://nomad-git-d-gh24311-parameterized-jobs-hashicorp.vercel.app/nomad/docs/job-specification/parameterized#interactions-with-periodic