Skip to content

feat(dotnet): migrated code from .NET pages - #5591

Open
flippedcoder wants to merge 39 commits into
mainfrom
mm/dotnet-migration-0
Open

flippedcoder wants to merge 39 commits into
mainfrom
mm/dotnet-migration-0

Conversation

@flippedcoder

@flippedcoder flippedcoder commented Oct 27, 2026 •

Copy link
Copy Markdown
Contributor

What does this PR do?

This moves all of the inline code into the docs code repo.

Notes to reviewers

@vercel

vercel Bot commented Oct 27, 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 29, 2026 3:58pm UTC

Request Review

@github-actions

github-actions Bot commented Oct 27, 2026 •

Copy link
Copy Markdown
Contributor

Snipsync coverage

SDK code lines in docs/ that come from Snipsync: 32.4% → 38.0% (+5.6 pts), 14,858 of 39,055 lines.

Section Snipsync lines Inline lines Snipsync % Change
develop/dotnet 35 → 2,285 2,071 → 0 1.7% → 100.0% +98.3 pts
All sections

All languages: 33.0% (15,534 of 47,024 lines).

Section Snipsync lines Inline lines Snipsync %
design-patterns 26 7,808 0.3%
develop/python 4,772 535 89.9%
guides 34 4,494 0.8%
develop/go 4,285 80 98.2%
develop/java 1,092 3,107 26.0%
develop/typescript 1,716 2,012 46.0%
develop/dotnet 2,285 0 100.0%
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 4,915 6,615 42.6%
Go 4,425 3,181 58.2%
Java 1,177 5,651 17.2%
TypeScript 1,883 4,470 29.6%
C# 2,360 462 83.6%
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 9,268
temporalio/samples-python 1,892
temporalio/samples-typescript 1,567
temporalio/samples-java 973
temporalio/features 579
temporalio/samples-go 384
temporalio/sdk-typescript 119
unattributed 35
temporalio/samples-php 30
temporalio/reference-app-orders-go 11

Compared with 50440c2. 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.

@flippedcoder
flippedcoder marked this pull request as ready for review October 28, 2026 18:51
@flippedcoder
flippedcoder requested a review from a team as a code owner October 28, 2026 18:51
Copilot AI balanced review requested due to automatic review settings October 28, 2026 18:51

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.

🟡 Changes recommended

The shared environment guide still uses the outdated EnvConfig namespace, and the Cloud Run deployment link points to a sample missing the promised configuration and deployment instructions.

2 open issues
What changed in this PR

This PR migrates .NET documentation examples to Snipsync-managed snippets from documentation-sdk-code-examples, connecting the SDK guides to shared source files.

Changes:

  • Adds synchronized examples across .NET Workflows, Activities, Clients, Workers, and testing guides.
  • Corrects sample syntax, API usage, source links, and quickstart instructions.
  • Updates Standalone Nexus Operation troubleshooting across SDK guides and the encyclopedia.
File Description
docs/​encyclopedia/​nexus/​standalone-nexus-operation.mdx Updates the disabled-operation troubleshooting command.
docs/​develop/​typescript/​nexus/​standalone-operations.mdx Adds local-server enablement troubleshooting.
docs/​develop/​python/​nexus/​standalone-operations.mdx Adds local-server enablement troubleshooting.
docs/​develop/​java/​nexus/​standalone-operations.mdx Adds local-server enablement troubleshooting.
docs/​develop/​go/​nexus/​standalone-operations.mdx Adds local-server enablement troubleshooting.
docs/​develop/​dotnet/​workflows/​workflow-streams.mdx Synchronizes streaming and subscriber examples.
docs/​develop/​dotnet/​workflows/​versioning.mdx Synchronizes patching and cutover examples.
docs/​develop/​dotnet/​workflows/​timers.mdx Synchronizes the Timer example; removes an obsolete comment.
docs/​develop/​dotnet/​workflows/​timeouts.mdx Synchronizes examples and corrects ExecutionTimeout.
docs/​develop/​dotnet/​workflows/​schedules.mdx Synchronizes Schedule examples and uses UTC for backfills.
docs/​develop/​dotnet/​workflows/​message-passing.mdx Synchronizes handler examples and corrects asynchronous calls.
docs/​develop/​dotnet/​workflows/​dynamic-workflow.mdx Synchronizes the example and fixes object construction.
docs/​develop/​dotnet/​workflows/​continue-as-new.mdx Synchronizes state-transfer and testing examples.
docs/​develop/​dotnet/​workflows/​child-workflows.mdx Synchronizes Child Workflow examples.
docs/​develop/​dotnet/​workflows/​cancellation.mdx Synchronizes examples and corrects Activity cancellation code.
docs/​develop/​dotnet/​workflows/​basics.mdx Synchronizes definition, initialization, and deterministic API examples.
docs/​develop/​dotnet/​workers/​serverless-workers/​cloud-run.mdx Migrates Worker, container, and telemetry examples.
docs/​develop/​dotnet/​workers/​serverless-workers/​aws-lambda.mdx Migrates Lambda and telemetry configuration examples.
docs/​develop/​dotnet/​workers/​run-worker-process.mdx Migrates Worker snippets and completes Activity registration.
docs/​develop/​dotnet/​workers/​interceptors.mdx Synchronizes interceptor examples and updates Worker execution.
docs/​develop/​dotnet/​set-up.mdx Synchronizes quickstart examples and corrects expected output.
docs/​develop/​dotnet/​platform/​observability.mdx Synchronizes metrics, logging, and Visibility examples.
docs/​develop/​dotnet/​platform/​enriching-ui.mdx Synchronizes UI metadata examples and updates logging.
docs/​develop/​dotnet/​nexus/​standalone-operations.mdx Migrates Client examples and adds enablement troubleshooting.
docs/​develop/​dotnet/​nexus/​quickstart.mdx Replaces embedded code strings with synchronized snippets.
docs/​develop/​dotnet/​nexus/​feature-guide.mdx Migrates Nexus handler, caller, and Worker examples.
docs/​develop/​dotnet/​client/​temporal-client.mdx Synchronizes connection examples and corrects configuration namespaces.
docs/​develop/​dotnet/​best-practices/​testing-suite.mdx Synchronizes tests and corrects waiting and replay examples.
docs/​develop/​dotnet/​best-practices/​error-handling.mdx Synchronizes exception-handling examples.
docs/​develop/​dotnet/​best-practices/​data-handling/​data-encryption.mdx Synchronizes codec examples and corrects metadata conversion.
docs/​develop/​dotnet/​best-practices/​data-handling/​data-conversion.mdx Synchronizes the converter example and fixes statement ordering.
docs/​develop/​dotnet/​activities/​timeouts.mdx Synchronizes timeout, retry, and Heartbeat examples.
docs/​develop/​dotnet/​activities/​standalone-activities.mdx Migrates examples and updates sample execution commands.
docs/​develop/​dotnet/​activities/​standalone-activities-quickstart.mdx Updates repository setup, project paths, and synchronized examples.
docs/​develop/​dotnet/​activities/​execution.mdx Synchronizes execution code and corrects Workflow definition syntax.
docs/​develop/​dotnet/​activities/​dynamic-activity.mdx Synchronizes the Dynamic Activity example.
docs/​develop/​dotnet/​activities/​benign-exceptions.mdx Synchronizes the benign-exception example.
docs/​develop/​dotnet/​activities/​basics.mdx Synchronizes the Activity definition example.
docs/​develop/​dotnet/​activities/​asynchronous-activity.mdx Synchronizes asynchronous completion examples.

Review effort: Balanced

to create a client. Connection options include the Temporal Server address, Namespace, and (optionally) TLS
configuration. You can provide these options directly in code, or load them from **environment variables** and/or a
**TOML configuration file** using the `Temporalio.Client.EnvConfig` helpers. We recommend environment variables or a
**TOML configuration file** using the `Temporalio.Common.EnvConfig` helpers. We recommend environment variables or a
Comment thread docs/develop/dotnet/workers/serverless-workers/cloud-run.mdx Outdated
- Use Temporalio.Common.EnvConfig in the shared environment configuration guide
- Point the Collector sidecar link back to samples-dotnet, which has the
  collector config, Worker Pool manifest, and deployment README
@Duncanma
Duncanma enabled auto-merge (squash) October 29, 2026 15:52

This branch was successfully deployed

1 active deployment
Preview — 9ae97911 Deployed Oct 29, 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.

3 participants