Skip to content

Document new Nexus Operation timeouts#4242

Merged
jsundai merged 5 commits intomainfrom
NEXUS-30
Mar 24, 2026
Merged

Document new Nexus Operation timeouts#4242
jsundai merged 5 commits intomainfrom
NEXUS-30

Conversation

@Quinn-With-Two-Ns
Copy link
Copy Markdown
Contributor

@Quinn-With-Two-Ns Quinn-With-Two-Ns commented Feb 26, 2026

What does this PR do?

Document new Nexus Operation timeouts schedule-to-start and start-to-close. We also didn't have any docs I could find for schedule-to-close so I added that. I think it would be good to show how to set these on a PR SDK basis as well, I was planning to put that in another PR.

Notes to reviewers

┆Attachments: EDU-5951 Document new Nexus Operation timeouts

@Quinn-With-Two-Ns Quinn-With-Two-Ns requested a review from a team as a code owner February 26, 2026 00:25
@vercel
Copy link
Copy Markdown

vercel Bot commented Feb 26, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
temporal-documentation Ready Ready Preview, Comment Mar 24, 2026 8:27pm

Request Review

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Feb 26, 2026

📖 Docs PR preview links

Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: ebd51b89d5

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/encyclopedia/nexus-operations.mdx Outdated

Once the caller Workflow schedules an Operation with the caller's Temporal Service, the caller's Nexus Machinery keeps trying to start the Operation.
If a [retryable Nexus error](/references/failures#nexus-errors) is returned the Nexus Machinery will retry until the Nexus Operation's Start-to-Close-Timeout is exceeded.
If a [retryable Nexus error](/references/failures#nexus-errors) is returned the Nexus Machinery will retry until the Nexus Operation's [Schedule-to-Close timeout](#schedule-to-close-timeout) is exceeded.
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Describe retries as ending at the earliest start-related timeout

This sentence says Nexus start retries continue until Schedule-to-Close, but the same page now documents Schedule-to-Start as the timeout for how long an operation may wait to be started (docs/encyclopedia/nexus-operations.mdx, line 218). In configurations where Schedule-to-Start is set lower than Schedule-to-Close (for example, no handler workers available), retries stop at Schedule-to-Start, so this wording gives readers the wrong timeout boundary for failure analysis and tuning.

Useful? React with 👍 / 👎.

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.

It would retry until the minimum of schedule to close and schedule to start.

Copy link
Copy Markdown
Contributor

@prasek prasek left a comment

Choose a reason for hiding this comment

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

lgtm, dropped a few suggestions

Comment thread docs/encyclopedia/nexus-operations.mdx Outdated
Comment thread docs/encyclopedia/nexus-operations.mdx Outdated
@jsundai jsundai self-assigned this Feb 26, 2026
Comment thread docs/encyclopedia/nexus-operations.mdx
Copy link
Copy Markdown
Contributor

@jsundai jsundai left a comment

Choose a reason for hiding this comment

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

LGTM - will do a deeper check on Monday.

Comment thread docs/encyclopedia/nexus-operations.mdx Outdated

Once the caller Workflow schedules an Operation with the caller's Temporal Service, the caller's Nexus Machinery keeps trying to start the Operation.
If a [retryable Nexus error](/references/failures#nexus-errors) is returned the Nexus Machinery will retry until the Nexus Operation's Start-to-Close-Timeout is exceeded.
If a [retryable Nexus error](/references/failures#nexus-errors) is returned the Nexus Machinery will retry until the Nexus Operation's [Schedule-to-Close timeout](#schedule-to-close-timeout) or [Schedule-to-close timeout](#schedule-to-close-timeout) is exceeded.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Schedule to Close timeout is put twice. Once this is fixed, looks good to merge! @Quinn-With-Two-Ns

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Done!

@jsundai jsundai merged commit e3cd4d3 into main Mar 24, 2026
10 checks passed
@jsundai jsundai deleted the NEXUS-30 branch March 24, 2026 20:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants