Skip to content

Nexus docs update#4262

Merged
jsundai merged 16 commits intomainfrom
nexus-docs-update
Mar 25, 2026
Merged

Nexus docs update#4262
jsundai merged 16 commits intomainfrom
nexus-docs-update

Conversation

@prasek
Copy link
Copy Markdown
Contributor

@prasek prasek commented Mar 1, 2026

What does this PR do?

Nexus docs update:

  • Rewrite evaluate page with production social proof (Duolingo, Netflix, Miro), outcome-focused benefits, and new light/dark SVG decision trees
  • Rewrite Nexus encyclopedia for clarity and concision
  • Add new Nexus Patterns page documenting collocated and router-queue deployment patterns
  • Expand payload encryption docs with three cross-Namespace approaches: shared key, KMS key ID in metadata, and endpoint-specific wrapper types
  • Add "Use the Temporal Client for Signals, Queries, and Updates" section with code examples in all five SDK guides (Go, Java, Python, TypeScript, .NET)
  • Add circuit breaker guidance across all SDK guides - handlers should be reliable since it trips after 5 consecutive errors
  • Condense all Cloud Nexus pages (index, security, limits, observability, latency, pricing) into scannable bullet lists linking to canonical sources
  • Add caution block for changing Endpoint target Namespace with drain recommendation, and document registry access control defaults
  • Update Cloud Namespace best practices to recommend Nexus instead of "Workflows should be in the same Namespace"
  • Remove deprecated use-cases page, fix broken links, fix typos, standardize sample names, and add Python/TypeScript/.NET to all SDK link lists

┆Attachments: EDU-5974 Nexus docs update

@vercel
Copy link
Copy Markdown

vercel Bot commented Mar 1, 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 25, 2026 0:03am

Request Review

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Mar 1, 2026

@prasek prasek marked this pull request as ready for review March 12, 2026 20:38
@prasek prasek requested a review from a team as a code owner March 12, 2026 20:38
Copy link
Copy Markdown
Contributor

@KeithB-Temporal KeithB-Temporal left a comment

Choose a reason for hiding this comment

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

This is a HUGE leap forward for Nexus documentation! Incredible work, Phil! I went through very thoroughly and added some comments to help support your great work and to make these changes even more awesome.

Comment thread docs/encyclopedia/nexus/nexus.mdx
Comment thread docs/encyclopedia/nexus/nexus.mdx
Comment thread docs/encyclopedia/nexus/nexus.mdx
Comment thread docs/encyclopedia/nexus/nexus.mdx
Comment thread docs/encyclopedia/nexus.mdx Outdated
Comment thread docs/encyclopedia/nexus-registry.mdx Outdated
Comment thread docs/encyclopedia/nexus/nexus-operations.mdx
Comment thread docs/production-deployment/self-hosted-guide/temporal-nexus.mdx Outdated
Comment thread docs/production-deployment/self-hosted-guide/temporal-nexus.mdx Outdated
Comment thread docs/production-deployment/self-hosted-guide/temporal-nexus.mdx Outdated
Comment thread docs/cloud/nexus/index.mdx
Copy link
Copy Markdown
Member

@bergundy bergundy left a comment

Choose a reason for hiding this comment

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

I didn't quite get to finish the review but since this has been open for a while now, I figured I would submit what I have so far.

Comment thread docs/cloud/nexus/latency-availability.mdx
Comment thread docs/cloud/nexus/limits.mdx Outdated
Comment thread docs/develop/dotnet/temporal-nexus.mdx
Comment thread docs/develop/dotnet/temporal-nexus.mdx Outdated
Comment thread docs/develop/go/temporal-nexus.mdx Outdated
Comment thread docs/encyclopedia/nexus-error-handling.mdx Outdated
Comment thread docs/encyclopedia/nexus-error-handling.mdx Outdated
Comment thread docs/encyclopedia/nexus-error-handling.mdx Outdated
Comment thread docs/encyclopedia/nexus/nexus-execution-debugging.mdx
Comment thread docs/encyclopedia/nexus-use-cases.mdx Outdated
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.

Are we concerned about broken links here?

prasek added 2 commits March 20, 2026 12:28
Signed-off-by: Phil Prasek <prasek@gmail.com>
Signed-off-by: Phil Prasek <prasek@gmail.com>
@jsundai
Copy link
Copy Markdown
Contributor

jsundai commented Mar 23, 2026

Going to do a deeper review, resolve the build failure, and make some edits on this PR sometime today.

Comment thread docs/encyclopedia/nexus/nexus.mdx
@jsundai
Copy link
Copy Markdown
Contributor

jsundai commented Mar 24, 2026

Taking final deep look at this. Merging this in today.

Comment thread docs/encyclopedia/nexus-endpoints.mdx
Corrected punctuation in the Nexus description.
@jsundai jsundai enabled auto-merge (squash) March 25, 2026 00:06
@jsundai jsundai disabled auto-merge March 25, 2026 00:06
@jsundai jsundai merged commit 62fac0e into main Mar 25, 2026
10 checks passed
@jsundai jsundai deleted the nexus-docs-update branch March 25, 2026 00:06
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.

5 participants