Skip to content

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

Closed
Evanthx wants to merge 26 commits into
mainfrom
nexus-v2
Closed

Evanthx wants to merge 26 commits into
mainfrom
nexus-v2

Conversation

@Evanthx

@Evanthx Evanthx commented Aug 7, 2026 •

Copy link
Copy Markdown
Contributor

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!!

@Evanthx
Evanthx requested a review from a team as a code owner August 7, 2026 22:16
@vercel

vercel Bot commented Aug 7, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated
temporal-documentation Error Error Oct 22, 2026 9:46pm UTC

Request Review

@github-actions

github-actions Bot commented Aug 7, 2026 •

Copy link
Copy Markdown
Contributor

❌ 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
        │ {
        │   "tags": [
        │     "Java SDK",
        │     "Temporal SDKs"
        │   ],
        │   "section_title": "Java SDK",
        │   "image": "https://docs.temporal.io/img/og/df0a91ba1c6f23c2.jpg"
        │ }
        │     at loadMDX (/home/runner/work/documentation/documentation/node_modules/@docusaurus/mdx-loader/lib/loader.js:41:23)
        │     at async Object.mdxLoader (/home/runner/work/documentation/documentation/node_modules/@docusaurus/mdx-loader/lib/loader.js:157:24)

--------------------------

╰─▶   × Error: Docusaurus MDX partial files should not contain front matter.
        │ Those partial files use the _ prefix as a convention by default, but this is configurable.
        │ File at /home/runner/work/documentation/documentation/docs/develop/java/nexus/development-walkthrough/_steps/overview.mdx contains front matter that will be ignored:
        │ {
        │   "tags": [
        │     "Java SDK",
        │     "Temporal SDKs"
        │   ],
        │   "section_title": "Java SDK",
        │   "image": "https://docs.temporal.io/img/og/f13a13434cb90916.jpg"
        │ }
        │     at loadMDX (/home/runner/work/documentation/documentation/node_modules/@docusaurus/mdx-loader/lib/loader.js:41:23)
        │     at async Object.mdxLoader (/home/runner/work/documentation/documentation/node_modules/@docusaurus/mdx-loader/lib/loader.js:157:24)

--------------------------

╰─▶   × Error: Docusaurus MDX partial files should not contain front matter.
        │ Those partial files use the _ prefix as a convention by default, but this is configurable.
        │ File at /home/runner/work/documentation/documentation/docs/develop/java/nexus/development-walkthrough/_steps/publish-in-nexus.mdx contains front matter that will be ignored:
        │ {
        │   "tags": [
        │     "Java SDK",
        │     "Temporal SDKs"
        │   ],
        │   "section_title": "Java SDK",
        │   "image": "https://docs.temporal.io/img/og/76aa4788df7fc451.jpg"
        │ }
        │     at loadMDX (/home/runner/work/documentation/documentation/node_modules/@docusaurus/mdx-loader/lib/loader.js:41:23)
        │     at async Object.mdxLoader (/home/runner/work/documentation/documentation/node_modules/@docusaurus/mdx-loader/lib/loader.js:157:24)

--------------------------

╰─▶   × Error: Docusaurus MDX partial files should not contain front matter.
        │ Those partial files use the _ prefix as a convention by default, but this is configurable.
        │ File at /home/runner/work/documentation/documentation/docs/develop/java/nexus/development-walkthrough/_steps/send-messages.mdx contains front matter that will be ignored:
        │ {
        │   "tags": [
        │     "Java SDK",
        │     "Temporal SDKs"
        │   ],
        │   "section_title": "Java SDK",
        │   "image": "https://docs.temporal.io/img/og/ea5165ab6450b778.jpg"
        │ }
        │     at loadMDX (/home/runner/work/documentation/documentation/node_modules/@docusaurus/mdx-loader/lib/loader.js:41:23)
        │     at async Object.mdxLoader (/home/runner/work/documentation/documentation/node_modules/@docusaurus/mdx-loader/lib/loader.js:157:24)
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

github-actions Bot commented Aug 7, 2026 •

Copy link
Copy Markdown
Contributor

📖 Docs PR preview links

@@ -0,0 +1,254 @@
---
id: nexus-standalone-activity
title: Nexus Standalone Activity

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.

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

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.

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

@github-actions

github-actions Bot commented Oct 13, 2026 •

Copy link
Copy Markdown
Contributor

Snipsync coverage

SDK code lines in docs/ that come from Snipsync: 24.7% → 25.5% (+0.8 pts), 9,824 of 38,543 lines.

Section Snipsync lines Inline lines Snipsync % Change
develop/java 695 → 1,101 3,105 → 3,108 18.3% → 26.2% +7.9 pts
All sections

All languages: 22.3% (10,375 of 46,501 lines).

Section Snipsync lines Inline lines Snipsync %
design-patterns 26 7,808 0.3%
develop/python 1,747 2,971 37.0%
guides 34 4,494 0.8%
develop/go 4,285 80 98.2%
develop/java 1,101 3,108 26.2%
develop/typescript 1,948 2,026 49.0%
develop/dotnet 35 2,071 1.7%
develop/rust 0 1,257 0.0%
develop/php 30 1,144 2.6%
develop/ruby 21 1,145 1.8%
develop 484 604 44.5%
production-deployment 54 805 6.3%
encyclopedia 0 837 0.0%
develop/worker-performance 48 177 21.3%
cloud 0 127 0.0%
references 0 48 0.0%
best-practices 11 17 39.3%
Language Snipsync lines Inline lines Snipsync %
Python 1,890 9,051 17.3%
Go 4,425 3,181 58.2%
Java 1,186 5,652 17.3%
TypeScript 2,115 4,484 32.1%
C# 110 2,533 4.2%
Ruby 68 1,326 4.9%
Rust 0 1,324 0.0%
PHP 30 1,168 2.5%
Snipsync origin Lines
temporalio/documentation-sdk-code-examples 4,028
temporalio/samples-typescript 1,799
temporalio/samples-python 1,729
temporalio/samples-java 982
temporalio/features 699
temporalio/samples-go 384
temporalio/sdk-typescript 119
unattributed 35
temporalio/samples-php 30
temporalio/reference-app-orders-go 11
temporalio/samples-dotnet 8

Compared with 8a026cb. Counts non-blank lines in fenced code blocks tagged with an SDK language. Hand-written code isn't compiled anywhere; code Snipsync pulls from a sample repository is built in that repository's CI. See UTILITIES.md.

@jsundai

jsundai commented Oct 27, 2026

Copy link
Copy Markdown
Contributor

Merged via #5444

@jsundai jsundai closed this Oct 27, 2026

This branch had an error being deployed

1 failed deployment
Preview — f9b5f8c5 Deployed Oct 22, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

do-not-merge What it says on the label

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants