docs: clarify changeDelay method behavior in TSDoc and user documentation

[Copilot]

• Analyze the current behavior of changeDelay method
• Update TSDoc comment in src/classes/job.ts to clarify behavior
• Update user documentation in docs/gitbook/guide/jobs/delayed.md
• Verify the change improves clarity
• Run linter to ensure no style issues
• Build TypeScript to ensure no compilation errors
• Revert yarn.lock changes as requested

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Wording of changeDelay(…) is confusing</issue_title>
<issue_description>Is your feature request related to a problem? Please describe.
The purpose of changeDelay(delay: number) is confusing: the method name implies "replace old delay with the new one", while the JSDoc says "milliseconds to be added to current time".

Describe the solution you'd like
An argument named delta or difference or something similar (instead of delay) would be helpful. delay implies "new delay".

Describe alternatives you've considered
Introduce a method that takes in a new timestamp (i.e., "add five seconds" = resetDelay(Date.now() + 5000)).

Additional context
n/a
</issue_description>

<agent_instructions>Modify tsdoc description of changeDelay to be more accurate</agent_instructions>

Comments on the Issue (you are @copilot in this section)

Fixes #3494

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[roggervalf]

@copilot do not change yarn.lock

[Copilot]

@copilot do not change yarn.lock

Reverted yarn.lock to its original state in commit 0d98d9c.

[Copilot]

Pull Request Overview

Improves clarity of the changeDelay method's behavior by updating its TSDoc documentation and user guide. The documentation now clearly explains that the method reschedules a job to execute after a specified delay from the current time, rather than adding time to the original delay.

• Updated TSDoc comment in job.ts to clarify that changeDelay sets a new delay from current time
• Enhanced user documentation in delayed.md with clearer explanation and example comment
• Added practical example showing the method reschedules jobs relative to current time

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File	Description
src/classes/job.ts	Updated TSDoc comment to clarify changeDelay behavior with detailed explanation and parameter description
docs/gitbook/guide/jobs/delayed.md	Enhanced user documentation with clearer wording and added explanatory comment to code example

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}