Updated for Nexus SDK Ergonomics - Not ready to be merged yet!! - #5203
Open
Evanthx wants to merge 1 commit into
Open
Updated for Nexus SDK Ergonomics - Not ready to be merged yet!!#5203Evanthx wants to merge 1 commit into
Evanthx wants to merge 1 commit into
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Contributor
📖 Docs PR preview links
|
Contributor
There was a problem hiding this comment.
🟡 Changes recommended
The Java guide duplicates existing documentation, lacks a runnable generated-contract setup, and leaves related Nexus pages inconsistent.
Once you've addressed the issues Copilot identified, you can request another Copilot review.
Pull request overview
Adds prerelease Nexus SDK ergonomics documentation and a Java implementation guide.
Changes:
- Documents the unified Temporal Operation Handler, code generation, and Activity-backed Operations.
- Adds a Java prerelease developer guide.
- Adds the new pages to Nexus navigation.
File summaries
| File | Description |
|---|---|
sidebars.js |
Registers and groups the new pages. |
docs/encyclopedia/nexus/temporal-operation-handler.mdx |
Explains the unified handler API. |
docs/encyclopedia/nexus/nexus-standalone-activity.mdx |
Describes Activity-backed Operations. |
docs/encyclopedia/nexus/nexus-code-generator.mdx |
Introduces generated Nexus contracts. |
docs/develop/java/nexus/developer-experience.mdx |
Provides Java usage and deployment guidance. |
Review details
- Files reviewed: 5/5 changed files
- Comments generated: 4
- Review effort level: Balanced
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
Comment on lines
+4
to
+6
| title: Nexus Developer Experience - Java SDK feature guide | ||
| sidebar_label: Nexus Developer Experience | ||
| description: Build a Nexus Service in Java with the pre-release APIs - the Temporal Operation Handler, Activity-backed Operations, and a generated Service contract. |
| APIs are experimental and may be subject to backwards-incompatible changes. | ||
| </ReleaseNoteHeader> | ||
|
|
||
| Temporal has unified the Workflow handler and the synchronous operation handler into a single handler, and added the ability to back an Operation with a [Standalone Activity](/nexus/standalone-activity). |
Comment on lines
+19
to
+20
| The Nexus Code Generator, [`nexgen`](https://github.com/temporalio/nex-gen), turns one schema into client code for Go, Java, Python, and TypeScript. | ||
| Both sides of a [Nexus Service](/nexus/services) generate from the same file, so neither hand-writes the types and neither can drift from the contract. |
Comment on lines
+95
to
+97
| You can hand-write that package, but the preferred way is to generate it with the [Nexus Code Generator](https://github.com/temporalio/nex-gen). | ||
| You write the contract once as a JSON definition file and run `nexgen` against it, and it emits the typed models, | ||
| runtime validators, and the Service definition itself. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This adds and updates some information about Nexus SDK ergonomics.
Note for documentation reviewers - do not review or merge yet!