Skip to content

Add page on when to use Workflows vs Nexus vs SANO vs SAA - #5566

Merged
jsundai merged 11 commits into
mainfrom
when-to-use-nexus-sano-saa
Oct 28, 2026
Merged

jsundai merged 11 commits into
mainfrom
when-to-use-nexus-sano-saa

Conversation

@jsundai

@jsundai jsundai commented Oct 23, 2026 •

Copy link
Copy Markdown
Contributor

What does this PR do?

Adds a new Encyclopedia page, /nexus/choosing-an-approach, covering which mechanism to
reach for among four options: starting a Workflow directly, exposing a Nexus Service,
calling one with a Standalone Nexus Operation, and backing an Operation with a Nexus
Standalone Activity.

The page is a capability table followed by three decisions: whether you need a service
boundary, how to call the Service, and how to implement the Operation.

Also adds the sidebar entry under Encyclopedia > Temporal Nexus.

@jsundai
jsundai requested a review from a team as a code owner October 23, 2026 19:58
Copilot AI balanced review requested due to automatic review settings October 23, 2026 19:58
@vercel

vercel Bot commented Oct 23, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated
temporal-documentation Ready Ready Preview Oct 28, 2026 9:21pm UTC

Request Review

Copilot AI left a comment

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.

Copilot was unable to review this pull request because the user who requested the review has insufficient remaining quota.

@github-actions

github-actions Bot commented Oct 23, 2026 •

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

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.

🟢 Approval recommended

The focused documentation addition fits the Encyclopedia structure and has no unresolved findings within the review scope.

No open issues 🎉

Review effort: Balanced

@Duncanma

Copy link
Copy Markdown
Contributor

Great set of changes! Do you want/need to run this past any of the Nexus folks?

This bit

Nexus is Generally Available. Standalone Nexus Operations and Nexus Standalone Activities are at Pre-release, so their APIs are experimental and may change in backwards-incompatible ways.

image

just stuck on the end of the intro paragraph feels like too much rapid fire info, can you wrap it in an ::info ?

Comment thread docs/encyclopedia/nexus/choosing-a-nexus-approach.mdx Outdated
Comment thread docs/encyclopedia/nexus/choosing-a-nexus-approach.mdx Outdated
@jsundai

jsundai commented Oct 28, 2026

Copy link
Copy Markdown
Contributor Author

Good catch!

@lennessyy

lennessyy commented Oct 28, 2026 •

Copy link
Copy Markdown
Contributor

For When to call a Nexus Operation, we say "The Operation is part of a multi-step orchestrated process."

This also sounds like a normal workflow. Can do say a little more to differentiate?

@jsundai
jsundai merged commit 277ffc9 into main Oct 28, 2026
18 checks passed
@jsundai
jsundai deleted the when-to-use-nexus-sano-saa branch October 28, 2026 21:23

This branch was successfully deployed

1 active deployment
Preview — bfad33b1 Deployed Oct 28, 2026 by vercel[bot]
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.

6 participants