Nexus V2 Documentation - don't review or merge!!

[Evanthx]

Note for documentation reviewers - do not review or merge. I am sending this to some internal folks as we are discussing what we want to do.

Microservice Development Walkthrough is main part of this PR.

Matching sample Java code: temporalio/samples-java#793

┆Attachments: EDU-6917 Nexus V2 Documentation - don't review or merge!!

[vercel]

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

Project	Deployment	Actions	Updated
temporal-documentation	Error		Sep 10, 2026 11:28pm UTC

[github-actions]

❌ Docs build failed

We couldn't automatically identify the specific error from the build output. Here are the last 60 lines of the build log:

Build log tail

              at renderNodeDestructive (server.bundle.js:25267:7)
              at finishFunctionComponent (server.bundle.js:24658:9)
              at renderElement (server.bundle.js:24757:7)
              at retryNode (server.bundle.js:25473:16)
              at renderNodeDestructive (server.bundle.js:25267:7)
              at renderNode (server.bundle.js:25834:14)
        },
        Error: Can't render static file for pathname "/encyclopedia/event-history/event-history-java"
            at generateStaticFile (/home/runner/work/documentation/documentation/node_modules/@docusaurus/core/lib/ssg/ssgRenderer.js:131:20)
            at async /home/runner/work/documentation/documentation/node_modules/p-map/index.js:57:22 {
          [cause]: TypeError: Cannot read properties of undefined (reading 'lines')
              at WorkflowWalkthrough (/home/runner/work/documentation/documentation/build/__server/assets/js/98129899.cb3f7b9d.js:7017:37)
              at renderWithHooks (server.bundle.js:24617:18)
              at renderElement (server.bundle.js:24755:14)
              at retryNode (server.bundle.js:25473:16)
              at renderNodeDestructive (server.bundle.js:25267:7)
              at finishFunctionComponent (server.bundle.js:24658:9)
              at renderElement (server.bundle.js:24757:7)
              at retryNode (server.bundle.js:25473:16)
              at renderNodeDestructive (server.bundle.js:25267:7)
              at renderNode (server.bundle.js:25834:14)
        },
        Error: Can't render static file for pathname "/encyclopedia/event-history/event-history-python"
            at generateStaticFile (/home/runner/work/documentation/documentation/node_modules/@docusaurus/core/lib/ssg/ssgRenderer.js:131:20)
            at async /home/runner/work/documentation/documentation/node_modules/p-map/index.js:57:22 {
          [cause]: TypeError: Cannot read properties of undefined (reading 'lines')
              at WorkflowWalkthrough (/home/runner/work/documentation/documentation/build/__server/assets/js/98129899.cb3f7b9d.js:7017:37)
              at renderWithHooks (server.bundle.js:24617:18)
              at renderElement (server.bundle.js:24755:14)
              at retryNode (server.bundle.js:25473:16)
              at renderNodeDestructive (server.bundle.js:25267:7)
              at finishFunctionComponent (server.bundle.js:24658:9)
              at renderElement (server.bundle.js:24757:7)
              at retryNode (server.bundle.js:25473:16)
              at renderNodeDestructive (server.bundle.js:25267:7)
              at renderNode (server.bundle.js:25834:14)
        },
        Error: Can't render static file for pathname "/encyclopedia/event-history/event-history-typescript"
            at generateStaticFile (/home/runner/work/documentation/documentation/node_modules/@docusaurus/core/lib/ssg/ssgRenderer.js:131:20)
            at async /home/runner/work/documentation/documentation/node_modules/p-map/index.js:57:22 {
          [cause]: TypeError: Cannot read properties of undefined (reading 'lines')
              at WorkflowWalkthrough (/home/runner/work/documentation/documentation/build/__server/assets/js/538a6779.d29ff9fc.js:5673:37)
              at renderWithHooks (server.bundle.js:24617:18)
              at renderElement (server.bundle.js:24755:14)
              at retryNode (server.bundle.js:25473:16)
              at renderNodeDestructive (server.bundle.js:25267:7)
              at finishFunctionComponent (server.bundle.js:24658:9)
              at renderElement (server.bundle.js:24757:7)
              at retryNode (server.bundle.js:25473:16)
              at renderNodeDestructive (server.bundle.js:25267:7)
              at renderNode (server.bundle.js:25834:14)
        }
      ]
    }
  }
}
[INFO] Docusaurus version: 3.10.2
Node version: v24.20.0
error Command failed with exit code 1.
info Visit https://yarnpkg.com/en/docs/cli/run for documentation about this command.

Run yarn build locally to reproduce the full error.

[github-actions]

📖 Docs PR preview links

• Develop
  • Dotnet
    • Nexus
      • Activity-backed Operations
      • Temporal Operation Handler
  • Go
    • Nexus
      • Activity-backed Operations
      • Client Code Generator
      • Temporal Operation Handler
  • Java
    • Nexus
      • Activity-backed Operations
      • Client Code Generator
      • Microservice Development Walkthrough
      • Temporal Operation Handler
  • Python
    • Nexus
      • Activity-backed Operations
      • Client Code Generator
      • Temporal Operation Handler
  • Typescript
    • Nexus
      • Activity-backed Operations
      • Client Code Generator
      • Temporal Operation Handler
• Temporal Nexus
  • Nexus Client Code Generator
  • Nexus Standalone Activity
  • Temporal Operation Handler

[KeithB-Temporal]

Reading this gave me an interesting thought . Should this doc live under SAA rather than under Nexus. The PRD names this feature is Standalone Activity: Start from Nexus, which is actually a clearer name for this. If we leave here the name really should be something like Standalone Activity Started By Nexus

[Evanthx]

I had a lot of similar thoughts about naming confusion. I'm not at all sure!

[Quinn-With-Two-Ns]

Nit: I think we can remove this from all the code since it is not needed

[jsundai]

In the process of reworking this (moving this into the sidebar, turning it into one page, added tabbed component, etc) - gonna make a few more commits and then I'll review the content.