From 1614ad5ac2c3200a1b4c03a9da33f87de8805d19 Mon Sep 17 00:00:00 2001 From: Jwahir Sundai Date: Thu, 10 Sep 2026 16:55:38 -0500 Subject: [PATCH 1/7] pass at activity audit --- .../dotnet/activities/asynchronous-activity.mdx | 6 +++--- docs/develop/dotnet/activities/basics.mdx | 3 ++- .../dotnet/activities/dynamic-activity.mdx | 3 ++- docs/develop/dotnet/activities/execution.mdx | 4 ++-- docs/develop/dotnet/activities/index.mdx | 7 ++++--- .../standalone-activities-quickstart.mdx | 2 +- .../dotnet/activities/standalone-activities.mdx | 2 +- docs/develop/dotnet/activities/timeouts.mdx | 4 ++-- .../go/activities/asynchronous-activity.mdx | 2 +- docs/develop/go/activities/basics.mdx | 11 ++++++----- docs/develop/go/activities/dynamic-activity.mdx | 3 ++- docs/develop/go/activities/execution.mdx | 12 ++++++------ docs/develop/go/activities/index.mdx | 7 ++++--- .../standalone-activities-quickstart.mdx | 2 +- .../go/activities/standalone-activities.mdx | 2 +- docs/develop/go/activities/timeouts.mdx | 6 +++--- .../java/activities/asynchronous-activity.mdx | 4 ++-- docs/develop/java/activities/basics.mdx | 7 ++++--- docs/develop/java/activities/execution.mdx | 12 ++++++------ docs/develop/java/activities/index.mdx | 5 +++-- .../standalone-activities-quickstart.mdx | 2 +- .../java/activities/standalone-activities.mdx | 2 +- docs/develop/java/activities/timeouts.mdx | 6 +++++- .../php/activities/asynchronous-activity.mdx | 2 +- docs/develop/php/activities/basics.mdx | 15 ++++++++------- docs/develop/php/activities/execution.mdx | 12 ++++++------ docs/develop/php/activities/index.mdx | 7 ++++--- docs/develop/php/activities/timeouts.mdx | 14 +++++++------- .../python/activities/asynchronous-activity.mdx | 4 ++-- docs/develop/python/activities/basics.mdx | 5 +++-- docs/develop/python/activities/execution.mdx | 4 ++-- docs/develop/python/activities/index.mdx | 7 ++++--- .../standalone-activities-quickstart.mdx | 2 +- .../python/activities/standalone-activities.mdx | 2 +- docs/develop/python/activities/timeouts.mdx | 2 +- .../ruby/activities/asynchronous-activity.mdx | 6 +++--- docs/develop/ruby/activities/basics.mdx | 5 +++-- docs/develop/ruby/activities/dynamic-activity.mdx | 7 ++++--- docs/develop/ruby/activities/execution.mdx | 4 ++-- docs/develop/ruby/activities/index.mdx | 7 ++++--- .../standalone-activities-quickstart.mdx | 2 +- .../ruby/activities/standalone-activities.mdx | 2 +- docs/develop/ruby/activities/timeouts.mdx | 2 +- docs/develop/rust/activities/basics.mdx | 3 ++- docs/develop/rust/activities/execution.mdx | 4 ++-- docs/develop/rust/activities/index.mdx | 4 ++-- docs/develop/rust/activities/timeouts.mdx | 4 ++-- .../activities/asynchronous-activity.mdx | 6 +++--- docs/develop/typescript/activities/basics.mdx | 12 ++++++------ docs/develop/typescript/activities/execution.mdx | 10 +++++----- docs/develop/typescript/activities/index.mdx | 7 ++++--- .../standalone-activities-quickstart.mdx | 2 +- .../activities/standalone-activities.mdx | 2 +- docs/develop/typescript/activities/timeouts.mdx | 6 +++--- 54 files changed, 153 insertions(+), 132 deletions(-) diff --git a/docs/develop/dotnet/activities/asynchronous-activity.mdx b/docs/develop/dotnet/activities/asynchronous-activity.mdx index f7b97cf8ee..6f4879314f 100644 --- a/docs/develop/dotnet/activities/asynchronous-activity.mdx +++ b/docs/develop/dotnet/activities/asynchronous-activity.mdx @@ -1,12 +1,12 @@ --- id: asynchronous-activity -title: Asynchronous Activity completion - .NET SDK -sidebar_label: Asynchronous Activity completion +title: Asynchronous Activity Completion - .NET SDK +sidebar_label: Asynchronous Activity Completion description: Asynchronously complete an Activity in Temporal. Follow simple steps to allow an Activity Function to return without the Activity Execution completing. toc_max_heading_level: 4 tags: - Activities - - .Net SDK + - .NET SDK - Temporal SDKs --- diff --git a/docs/develop/dotnet/activities/basics.mdx b/docs/develop/dotnet/activities/basics.mdx index 2366e7a5ff..6a0e10967a 100644 --- a/docs/develop/dotnet/activities/basics.mdx +++ b/docs/develop/dotnet/activities/basics.mdx @@ -2,9 +2,10 @@ id: basics title: Activity basics - .NET SDK sidebar_label: Activity basics -description: This section explains Activity basics with the .NET SDK +description: Define an Activity with the Temporal .NET SDK, pass a single parameter object within Payload size limits, and customize the Activity Type name. toc_max_heading_level: 4 tags: + - Activities - .NET SDK - Temporal SDKs --- diff --git a/docs/develop/dotnet/activities/dynamic-activity.mdx b/docs/develop/dotnet/activities/dynamic-activity.mdx index 726c2780fa..87f7a6795b 100644 --- a/docs/develop/dotnet/activities/dynamic-activity.mdx +++ b/docs/develop/dotnet/activities/dynamic-activity.mdx @@ -2,9 +2,10 @@ id: dynamic-activity title: Dynamic Activity - .NET SDK sidebar_label: Dynamic Activity -description: This section explains Dynamic Activities with the .NET SDK +description: Register a Dynamic Activity with the Temporal .NET SDK to handle Activity Types that no other registered Activity implementation matches. toc_max_heading_level: 4 tags: + - Activities - .NET SDK - Temporal SDKs --- diff --git a/docs/develop/dotnet/activities/execution.mdx b/docs/develop/dotnet/activities/execution.mdx index 5b4d375ca0..23bbfe7469 100644 --- a/docs/develop/dotnet/activities/execution.mdx +++ b/docs/develop/dotnet/activities/execution.mdx @@ -1,14 +1,14 @@ --- id: execution title: Activity execution - .NET SDK -description: Shows how to perform Activity execution with the .NET SDK +description: Spawn an Activity Execution from a Workflow with the Temporal .NET SDK, set the required Activity Timeouts, and get the Activity's result. sidebar_label: Activity execution slug: /develop/dotnet/activities/execution toc_max_heading_level: 3 tags: + - Activities - .NET SDK - Temporal SDKs - - Activity --- ## Start Activity Execution {/* #activity-execution */} diff --git a/docs/develop/dotnet/activities/index.mdx b/docs/develop/dotnet/activities/index.mdx index 8c26b6cdbf..81214eb2b1 100644 --- a/docs/develop/dotnet/activities/index.mdx +++ b/docs/develop/dotnet/activities/index.mdx @@ -2,9 +2,10 @@ id: index title: Activities - .NET SDK sidebar_label: Activities -description: This section explains how to implement Activities with the .NET SDK +description: Define Activities, spawn Activity Executions, set Timeouts and Retry Policies, run Standalone Activities, and mark benign errors in .NET. toc_max_heading_level: 4 tags: + - Activities - .NET SDK - Temporal SDKs --- @@ -22,8 +23,8 @@ import * as Components from '@site/src/components'; - [Activity basics](/develop/dotnet/activities/basics) - [Activity execution](/develop/dotnet/activities/execution) - [Standalone Activities Quickstart](/develop/dotnet/activities/standalone-activities-quickstart) -- [Standalone Activities Feature Guide](/develop/dotnet/activities/standalone-activities) +- [Standalone Activities](/develop/dotnet/activities/standalone-activities) - [Timeouts](/develop/dotnet/activities/timeouts) -- [Asynchronous Activity completion](/develop/dotnet/activities/asynchronous-activity) +- [Asynchronous Activity Completion](/develop/dotnet/activities/asynchronous-activity) - [Dynamic Activity](/develop/dotnet/activities/dynamic-activity) - [Benign exceptions](/develop/dotnet/activities/benign-exceptions) diff --git a/docs/develop/dotnet/activities/standalone-activities-quickstart.mdx b/docs/develop/dotnet/activities/standalone-activities-quickstart.mdx index 76dd0ac62c..bb8b0539a5 100644 --- a/docs/develop/dotnet/activities/standalone-activities-quickstart.mdx +++ b/docs/develop/dotnet/activities/standalone-activities-quickstart.mdx @@ -1,6 +1,6 @@ --- id: standalone-activities-quickstart -title: Standalone Activities .NET Quickstart +title: Standalone Activities Quickstart - .NET SDK sidebar_label: Quickstart description: Execute a Standalone Activity with the Temporal .NET SDK without writing a Workflow. tags: diff --git a/docs/develop/dotnet/activities/standalone-activities.mdx b/docs/develop/dotnet/activities/standalone-activities.mdx index da70f9028d..c88de6d83d 100644 --- a/docs/develop/dotnet/activities/standalone-activities.mdx +++ b/docs/develop/dotnet/activities/standalone-activities.mdx @@ -1,6 +1,6 @@ --- id: standalone-activities -title: Standalone Activities Feature Guide +title: Standalone Activities - .NET SDK sidebar_label: Feature Guide toc_max_heading_level: 4 tags: diff --git a/docs/develop/dotnet/activities/timeouts.mdx b/docs/develop/dotnet/activities/timeouts.mdx index c4350ac321..df48f9514c 100644 --- a/docs/develop/dotnet/activities/timeouts.mdx +++ b/docs/develop/dotnet/activities/timeouts.mdx @@ -2,7 +2,7 @@ id: timeouts title: Activity Timeouts - .NET SDK sidebar_label: Timeouts -description: Optimize Workflow Execution with Temporal .NET SDK - Set Activity Timeouts and Retry Policies efficiently. +description: Set Activity Timeouts and a Retry Policy with the Temporal .NET SDK, override the next retry delay, and Heartbeat long-running Activities. toc_max_heading_level: 4 tags: - Activities @@ -57,7 +57,7 @@ return await Workflow.ExecuteActivityAsync( }); ``` -### Override the Retry interval with `nextRetryDelay` {/* #next-retry-delay */} +### Override the retry interval with `nextRetryDelay` {/* #next-retry-delay */} When you throw an [Application Failure](/references/failures#application-failure) and assign the `nextRetryDelay` field, its value replaces and overrides the Retry interval defined in the active Retry Policy. diff --git a/docs/develop/go/activities/asynchronous-activity.mdx b/docs/develop/go/activities/asynchronous-activity.mdx index c2b891e8ed..8458623988 100644 --- a/docs/develop/go/activities/asynchronous-activity.mdx +++ b/docs/develop/go/activities/asynchronous-activity.mdx @@ -1,6 +1,6 @@ --- id: asynchronous-activity -title: Asynchronous Activity completion - Go SDK +title: Asynchronous Activity Completion - Go SDK sidebar_label: Asynchronous Activity Completion toc_max_heading_level: 4 tags: diff --git a/docs/develop/go/activities/basics.mdx b/docs/develop/go/activities/basics.mdx index 0d36bfb5d4..9e6785386c 100644 --- a/docs/develop/go/activities/basics.mdx +++ b/docs/develop/go/activities/basics.mdx @@ -2,14 +2,15 @@ id: basics title: Activity basics - Go SDK sidebar_label: Activity basics -description: This section explains Activity basics with the Go SDK +description: Define an Activity with the Temporal Go SDK, pass a single parameter object within Payload size limits, and customize the Activity Type name. toc_max_heading_level: 4 tags: + - Activities - Go SDK - Temporal SDKs --- -## How to develop an Activity Definition in Go {/* #activity-definition */} +## Develop an Activity Definition {/* #activity-definition */} In the Temporal Go SDK programming model, an Activity Definition is an exportable function or a `struct` method. @@ -71,7 +72,7 @@ func (a *YourActivityObject) YourActivityDefinition(ctx context.Context, param Y } ``` -### How to develop Activity Parameters {/* #activity-parameters */} +### Develop Activity parameters {/* #activity-parameters */} There is no explicit limit to the total number of parameters that an [Activity Definition](/activity-definition) may support. However, there is a limit to the total size of the data that ends up encoded into a gRPC message Payload. @@ -122,7 +123,7 @@ func (a *YourActivityObject) YourActivityDefinition(ctx context.Context, param Y } ``` -### How to define Activity return values {/* #activity-return-values */} +### Define Activity return values {/* #activity-return-values */} All data returned from an Activity must be serializable. @@ -155,7 +156,7 @@ func (a *YourActivityObject) YourActivityDefinition(ctx context.Context, param Y } ``` -### How to customize Activity Type in Go {/* #customize-activity-type */} +### Customize Activity Type {/* #customize-activity-type */} To customize the Activity Type, set the `Name` parameter with `RegisterOptions` when registering your Activity with a Worker. diff --git a/docs/develop/go/activities/dynamic-activity.mdx b/docs/develop/go/activities/dynamic-activity.mdx index 0f5ab492e8..16feeadcb3 100644 --- a/docs/develop/go/activities/dynamic-activity.mdx +++ b/docs/develop/go/activities/dynamic-activity.mdx @@ -2,9 +2,10 @@ id: dynamic-activity title: Dynamic Activity - Go SDK sidebar_label: Dynamic Activity -description: This section explains Dynamic Activities with the Go SDK +description: Register a Dynamic Activity with the Temporal Go SDK to handle Activity Types that no other registered Activity implementation matches. toc_max_heading_level: 4 tags: + - Activities - Go SDK - Temporal SDKs --- diff --git a/docs/develop/go/activities/execution.mdx b/docs/develop/go/activities/execution.mdx index 6d48073d8d..e493ad0213 100644 --- a/docs/develop/go/activities/execution.mdx +++ b/docs/develop/go/activities/execution.mdx @@ -1,17 +1,17 @@ --- id: execution title: Activity execution - Go SDK -description: Shows how to perform Activity execution with the Go SDK -sidebar_label: Activity Execution +description: Spawn an Activity Execution from a Go Workflow, get its result, and set every ActivityOptions field, from Timeouts and Task Queue to Retry Policy. +sidebar_label: Activity execution slug: /develop/go/activities/execution toc_max_heading_level: 3 tags: + - Activities - Go SDK - Temporal SDKs - - Activity --- -## How to start an Activity Execution {/* #activity-execution */} +## Start an Activity Execution {/* #activity-execution */} Calls to spawn [Activity Executions](/activity-execution) are written within a [Workflow Definition](/workflow-definition). The call to spawn an Activity Execution generates the [ScheduleActivityTask](/references/commands#scheduleactivitytask) Command. @@ -56,7 +56,7 @@ func YourWorkflowDefinition(ctx workflow.Context, param YourWorkflowParam) (*You } ``` -### How to set the required Activity Timeouts {/* #required-timeout */} +### Set the required Activity Timeouts {/* #required-timeout */} Activity Execution semantics rely on several parameters. The only required value that needs to be set is either a [Schedule-To-Close Timeout](/encyclopedia/detecting-activity-failures#schedule-to-close-timeout) or a [Start-To-Close Timeout](/encyclopedia/detecting-activity-failures#start-to-close-timeout). @@ -288,7 +288,7 @@ if err != nil { } ``` -### How to get the results of an Activity Execution {/* #get-activity-results */} +### Get the results of an Activity Execution {/* #get-activity-results */} The call to spawn an [Activity Execution](/activity-execution) generates the [ScheduleActivityTask](/references/commands#scheduleactivitytask) Command and provides the Workflow with an Awaitable. Workflow Executions can either block progress until the result is available through the Awaitable or continue progressing, making use of the result when it becomes available. diff --git a/docs/develop/go/activities/index.mdx b/docs/develop/go/activities/index.mdx index 7abcf2251f..7786a4c58b 100644 --- a/docs/develop/go/activities/index.mdx +++ b/docs/develop/go/activities/index.mdx @@ -2,9 +2,10 @@ id: index title: Activities - Go SDK sidebar_label: Activities -description: This section explains how to implement Activities with the Go SDK +description: Define Activities, spawn Activity Executions, set Timeouts and Retry Policies, run Standalone Activities, and mark benign errors in Go. toc_max_heading_level: 4 tags: + - Activities - Go SDK - Temporal SDKs --- @@ -22,8 +23,8 @@ import * as Components from '@site/src/components'; - [Activity basics](/develop/go/activities/basics) - [Activity execution](/develop/go/activities/execution) - [Standalone Activities Quickstart](/develop/go/activities/standalone-activities-quickstart) -- [Standalone Activities Feature Guide](/develop/go/activities/standalone-activities) +- [Standalone Activities](/develop/go/activities/standalone-activities) - [Timeouts](/develop/go/activities/timeouts) -- [Asynchronous Activity completion](/develop/go/activities/asynchronous-activity) +- [Asynchronous Activity Completion](/develop/go/activities/asynchronous-activity) - [Dynamic Activity](/develop/go/activities/dynamic-activity) - [Benign exceptions](/develop/go/activities/benign-exceptions) diff --git a/docs/develop/go/activities/standalone-activities-quickstart.mdx b/docs/develop/go/activities/standalone-activities-quickstart.mdx index c18f88311b..4084b3d082 100644 --- a/docs/develop/go/activities/standalone-activities-quickstart.mdx +++ b/docs/develop/go/activities/standalone-activities-quickstart.mdx @@ -1,6 +1,6 @@ --- id: standalone-activities-quickstart -title: Standalone Activities Go Quickstart +title: Standalone Activities Quickstart - Go SDK sidebar_label: Quickstart description: Execute a Standalone Activity with the Temporal Go SDK without writing a Workflow. tags: diff --git a/docs/develop/go/activities/standalone-activities.mdx b/docs/develop/go/activities/standalone-activities.mdx index 62fbbb662c..35c0366d15 100644 --- a/docs/develop/go/activities/standalone-activities.mdx +++ b/docs/develop/go/activities/standalone-activities.mdx @@ -1,6 +1,6 @@ --- id: standalone-activities -title: Standalone Activities Feature Guide +title: Standalone Activities - Go SDK sidebar_label: Feature Guide toc_max_heading_level: 4 tags: diff --git a/docs/develop/go/activities/timeouts.mdx b/docs/develop/go/activities/timeouts.mdx index 4f02f8c722..2b8e313bb4 100644 --- a/docs/develop/go/activities/timeouts.mdx +++ b/docs/develop/go/activities/timeouts.mdx @@ -2,7 +2,7 @@ id: timeouts title: Activity Timeouts - Go SDK sidebar_label: Timeouts -description: Optimize Workflow Execution with Temporal Go SDK - Set Activity Timeouts and Retry Policies efficiently. +description: Set Activity Timeouts and a Retry Policy with the Temporal Go SDK, override the next retry delay, and Heartbeat long-running Activities. toc_max_heading_level: 4 tags: - Activities @@ -13,7 +13,7 @@ tags: - Temporal SDKs --- -## How to set Activity timeouts {/* #activity-timeouts */} +## Set Activity timeouts {/* #activity-timeouts */} Each Activity timeout controls the maximum duration of a different aspect of an Activity Execution. @@ -89,7 +89,7 @@ if err != nil { } ``` -### Overriding the retry interval with Next Retry Delay {/* #next-retry-delay */} +### Override the retry interval with `NextRetryDelay` {/* #next-retry-delay */} You may return an [Application Failure](/references/failures#application-failure) with the `NextRetryDelay` field set. This value will replace and override whatever the Retry interval would be on the Retry Policy. diff --git a/docs/develop/java/activities/asynchronous-activity.mdx b/docs/develop/java/activities/asynchronous-activity.mdx index 6166efe50f..87263fc4f9 100644 --- a/docs/develop/java/activities/asynchronous-activity.mdx +++ b/docs/develop/java/activities/asynchronous-activity.mdx @@ -1,7 +1,7 @@ --- id: asynchronous-activity -title: Asynchronous Activity completion - Java SDK -sidebar_label: Asynchronous Activity completion +title: Asynchronous Activity Completion - Java SDK +sidebar_label: Asynchronous Activity Completion toc_max_heading_level: 4 tags: - Activities diff --git a/docs/develop/java/activities/basics.mdx b/docs/develop/java/activities/basics.mdx index 4a46a2c118..a16dfcb091 100644 --- a/docs/develop/java/activities/basics.mdx +++ b/docs/develop/java/activities/basics.mdx @@ -2,9 +2,10 @@ id: basics title: Activity basics - Java SDK sidebar_label: Activity basics -description: This section explains how to implement Activities with the Java SDK +description: Define an Activity with the Temporal Java SDK, pass a single parameter object within Payload size limits, and customize the Activity Type name. toc_max_heading_level: 4 tags: + - Activities - Java SDK - Temporal SDKs --- @@ -157,7 +158,7 @@ public interface GreetingActivities { - Method Name: `composeGreeting` - Activity Type: `ComposeGreeting` -### Custom Prefix +### Custom prefix Using the `namePrefix` parameter in the `@ActivityInterface` annotation adds a prefix to each Activity Type name mentioned in the interface, unless the prefix is specifically overridden: @@ -178,7 +179,7 @@ public interface GreetingActivities { The Activity Type is capitalized, even when using a prefix. -### Custom Name +### Custom name To override the default name and any inherited prefixes, use the `name` parameter in the `@ActivityMethod` annotation: diff --git a/docs/develop/java/activities/execution.mdx b/docs/develop/java/activities/execution.mdx index 4ffd598292..1f916aea11 100644 --- a/docs/develop/java/activities/execution.mdx +++ b/docs/develop/java/activities/execution.mdx @@ -1,14 +1,14 @@ --- id: execution title: Activity execution - Java SDK -description: Shows how to perform Activity execution with the Java SDK -sidebar_label: Activity Execution +description: Invoke Activities synchronously or asynchronously from a Java Workflow, set ActivityOptions and Timeouts, and read the ActivityExecutionContext. +sidebar_label: Activity execution slug: /develop/java/activities/execution toc_max_heading_level: 3 tags: + - Activities - Java SDK - Temporal SDKs - - Activity --- ## Start an Activity Execution {/* #activity-execution */} @@ -46,7 +46,7 @@ Calling a method on the Activity interface schedules the Activity invocation wit Activities can be invoked synchronously or asynchronously. -### Invoking Activities Synchronously +### Invoke Activities synchronously In the following example, we use the type-safe `Workflow.newActivityStub` within the "FileProcessingWorkflow" Workflow implementation to create a client-side stub of the `FileProcessingActivities` class. We also define `ActivityOptions` and set `setStartToCloseTimeout` option to one hour. @@ -118,7 +118,7 @@ This is useful when the Activity type is not known at compile time, or to invoke activity.execute("ComposeGreeting", String.class, "Hello World", "Spanish"); ``` -### Invoking Activities Asynchronously +### Invoke Activities asynchronously Sometimes Workflows need to perform certain operations in parallel. The Temporal Java SDK provides the `Async` class which includes static methods used to invoke any Activity asynchronously. @@ -179,7 +179,7 @@ The following example shows how to call two Activity methods, "download" and "up } ``` -### Activity Execution Context +### ActivityExecutionContext `ActivityExecutionContext` is a context object passed to each Activity implementation by default. You can access it in your Activity implementations via `Activity.getExecutionContext()`. diff --git a/docs/develop/java/activities/index.mdx b/docs/develop/java/activities/index.mdx index 20b6e4484c..5979c98b75 100644 --- a/docs/develop/java/activities/index.mdx +++ b/docs/develop/java/activities/index.mdx @@ -2,9 +2,10 @@ id: index title: Activities - Java SDK sidebar_label: Activities -description: This section explains how to implement Activities with the Java SDK +description: Define Activities, spawn Activity Executions, set Timeouts and Retry Policies, run Standalone Activities, and mark benign errors in Java. toc_max_heading_level: 4 tags: + - Activities - Java SDK - Temporal SDKs --- @@ -22,7 +23,7 @@ import * as Components from '@site/src/components'; - [Activity basics](/develop/java/activities/basics) - [Activity execution](/develop/java/activities/execution) - [Standalone Activities Quickstart](/develop/java/activities/standalone-activities-quickstart) -- [Standalone Activities Feature Guide](/develop/java/activities/standalone-activities) +- [Standalone Activities](/develop/java/activities/standalone-activities) - [Timeouts](/develop/java/activities/timeouts) - [Asynchronous Activity Completion](/develop/java/activities/asynchronous-activity) - [Benign exceptions](/develop/java/activities/benign-exceptions) diff --git a/docs/develop/java/activities/standalone-activities-quickstart.mdx b/docs/develop/java/activities/standalone-activities-quickstart.mdx index 5ed927d359..2d0822e3b9 100644 --- a/docs/develop/java/activities/standalone-activities-quickstart.mdx +++ b/docs/develop/java/activities/standalone-activities-quickstart.mdx @@ -1,6 +1,6 @@ --- id: standalone-activities-quickstart -title: Standalone Activities Java Quickstart +title: Standalone Activities Quickstart - Java SDK sidebar_label: Quickstart description: Execute a Standalone Activity with the Temporal Java SDK without writing a Workflow. tags: diff --git a/docs/develop/java/activities/standalone-activities.mdx b/docs/develop/java/activities/standalone-activities.mdx index 24d316b4f8..399fc1e513 100644 --- a/docs/develop/java/activities/standalone-activities.mdx +++ b/docs/develop/java/activities/standalone-activities.mdx @@ -1,6 +1,6 @@ --- id: standalone-activities -title: Standalone Activities Feature Guide +title: Standalone Activities - Java SDK sidebar_label: Feature Guide toc_max_heading_level: 4 tags: diff --git a/docs/develop/java/activities/timeouts.mdx b/docs/develop/java/activities/timeouts.mdx index f8c219fcb0..928972bb5c 100644 --- a/docs/develop/java/activities/timeouts.mdx +++ b/docs/develop/java/activities/timeouts.mdx @@ -2,9 +2,13 @@ id: timeouts title: Activity Timeouts - Java SDK sidebar_label: Timeouts -description: This section explains how to set Activity Timeouts with the Java SDK +description: Set Activity Timeouts and a Retry Policy with the Temporal Java SDK, override the next retry delay, and Heartbeat long-running Activities. toc_max_heading_level: 4 tags: + - Activities + - Workflows + - Errors + - Failures - Java SDK - Temporal SDKs --- diff --git a/docs/develop/php/activities/asynchronous-activity.mdx b/docs/develop/php/activities/asynchronous-activity.mdx index 3cd790089b..92abb6c588 100644 --- a/docs/develop/php/activities/asynchronous-activity.mdx +++ b/docs/develop/php/activities/asynchronous-activity.mdx @@ -13,7 +13,7 @@ description: facilitating parallel operations in Workflows. --- -## How to asynchronously complete an Activity {/* #asynchronous-activity-completion */} +## Asynchronously complete an Activity {/* #asynchronous-activity-completion */} [Asynchronous Activity Completion](/activity-execution#asynchronous-activity-completion) enables the Activity Function to return without the Activity Execution completing. diff --git a/docs/develop/php/activities/basics.mdx b/docs/develop/php/activities/basics.mdx index f55cfed27f..d58ff8121b 100644 --- a/docs/develop/php/activities/basics.mdx +++ b/docs/develop/php/activities/basics.mdx @@ -1,15 +1,16 @@ --- id: basics -title: Activity Basics - PHP SDK -sidebar_label: Activity Basics -description: This section explains Activity Basics with the PHP SDK +title: Activity basics - PHP SDK +sidebar_label: Activity basics +description: Define an Activity with the Temporal PHP SDK, pass a single parameter object within Payload size limits, and customize the Activity Type name. toc_max_heading_level: 4 tags: + - Activities - PHP SDK - Temporal SDKs --- -## How to develop a basic Activity {/* #develop-activities */} +## Develop a basic Activity {/* #develop-activities */} One of the primary things that Workflows do is orchestrate the execution of Activities. An Activity is a normal function or method execution that's intended to execute a single, well-defined action (either short or long-running), such as querying a database, calling a third-party API, or transcoding a media file. @@ -36,7 +37,7 @@ interface FileProcessingActivities } ``` -### How to develop Activity Parameters {/* #activity-parameters */} +### Develop Activity parameters {/* #activity-parameters */} There is no explicit limit to the total number of parameters that an [Activity Definition](/activity-definition) may support. However, there is a limit to the total size of the data that ends up encoded into a gRPC message Payload. @@ -59,7 +60,7 @@ A single Workflow can use more than one Activity interface and call more than on The only requirement is that Activity method arguments and return values are serializable to a byte array using the provided [DataConverter](https://github.com/temporalio/sdk-php/blob/master/src/DataConverter/DataConverterInterface.php) interface. The default implementation uses a JSON serializer, but an alternative implementation can be easily configured. -### How to define Activity return values {/* #activity-return-values */} +### Define Activity return values {/* #activity-return-values */} All data returned from an Activity must be serializable. @@ -91,7 +92,7 @@ class GreetingActivity implements GreetingActivityInterface } ``` -### How to customize your Activity Type {/* #activity-type */} +### Customize your Activity Type {/* #activity-type */} Activities have a Type that are referred to as the Activity name. The following examples demonstrate how to set a custom name for your Activity Type. diff --git a/docs/develop/php/activities/execution.mdx b/docs/develop/php/activities/execution.mdx index f61960772b..b74648491d 100644 --- a/docs/develop/php/activities/execution.mdx +++ b/docs/develop/php/activities/execution.mdx @@ -1,17 +1,17 @@ --- id: execution title: Activity execution - PHP SDK -description: Shows how to perform Activity execution with the PHP SDK -sidebar_label: Activity Execution +description: Spawn an Activity Execution from a Workflow with the Temporal PHP SDK, set the required Activity Timeouts, and get the Activity's result. +sidebar_label: Activity execution slug: /develop/php/activities/execution toc_max_heading_level: 3 tags: + - Activities - PHP SDK - Temporal SDKs - - Activity --- -## How to start an Activity Execution {/* #activity-execution */} +## Start an Activity Execution {/* #activity-execution */} Calls to spawn [Activity Executions](/activity-execution) are written within a [Workflow Definition](/workflow-definition). The call to spawn an Activity Execution generates the [ScheduleActivityTask](/references/commands#scheduleactivitytask) Command. @@ -83,13 +83,13 @@ class FileProcessingActivitiesImpl implements FileProcessingActivities { } ``` -### How to set the required Activity Timeouts {/* #required-timeout */} +### Set the required Activity Timeouts {/* #required-timeout */} Activity Execution semantics rely on several parameters. The only required value that needs to be set is either a [Schedule-To-Close Timeout](/encyclopedia/detecting-activity-failures#schedule-to-close-timeout) or a [Start-To-Close Timeout](/encyclopedia/detecting-activity-failures#start-to-close-timeout). These values are set in the Activity Options. -### How to get the results of an Activity Execution {/* #get-activity-results */} +### Get the results of an Activity Execution {/* #get-activity-results */} The call to spawn an [Activity Execution](/activity-execution) generates the [ScheduleActivityTask](/references/commands#scheduleactivitytask) Command and provides the Workflow with an Awaitable. Workflow Executions can either block progress until the result is available through the Awaitable or continue progressing, making use of the result when it becomes available. diff --git a/docs/develop/php/activities/index.mdx b/docs/develop/php/activities/index.mdx index 3a60cdc66f..f259ccb6f0 100644 --- a/docs/develop/php/activities/index.mdx +++ b/docs/develop/php/activities/index.mdx @@ -2,9 +2,10 @@ id: index title: Activities - PHP SDK sidebar_label: Activities -description: This section explains how to implement Activities with the PHP SDK +description: Define Activities, spawn Activity Executions from a Workflow, set Activity Timeouts and Retry Policies, and complete Activities asynchronously in PHP. toc_max_heading_level: 4 tags: + - Activities - PHP SDK - Temporal SDKs --- @@ -19,7 +20,7 @@ import * as Components from '@site/src/components'; ## Activities -- [Activity Basics](/develop/php/activities/basics) -- [Activity Execution](/develop/php/activities/execution) +- [Activity basics](/develop/php/activities/basics) +- [Activity execution](/develop/php/activities/execution) - [Timeouts](/develop/php/activities/timeouts) - [Asynchronous Activity Completion](/develop/php/activities/asynchronous-activity) diff --git a/docs/develop/php/activities/timeouts.mdx b/docs/develop/php/activities/timeouts.mdx index b656ac817a..2afd1d0e26 100644 --- a/docs/develop/php/activities/timeouts.mdx +++ b/docs/develop/php/activities/timeouts.mdx @@ -2,7 +2,7 @@ id: timeouts title: Activity Timeouts - PHP SDK sidebar_label: Timeouts -description: Optimize Workflow Execution with Temporal PHP SDK - Set Activity Timeouts and Retry Policies efficiently. +description: Set Activity Timeouts and a Retry Policy with the Temporal PHP SDK, override the next retry delay, and Heartbeat long-running Activities. toc_max_heading_level: 4 tags: - Activities @@ -13,7 +13,7 @@ tags: - Temporal SDKs --- -## How to set Activity timeouts {/* #activity-timeouts */} +## Set Activity timeouts {/* #activity-timeouts */} Each Activity timeout controls the maximum duration of a different aspect of an Activity Execution. @@ -44,7 +44,7 @@ $this->greetingActivity = Workflow::newActivityStub( ); ``` -### How to set an Activity Retry Policy {/* #activity-retries */} +### Set an Activity Retry Policy {/* #activity-retries */} A Retry Policy works in cooperation with the timeouts to provide fine controls to optimize the execution experience. @@ -70,13 +70,13 @@ $this->greetingActivity = Workflow::newActivityStub( For an executable code sample, see [ActivityRetry sample](https://github.com/temporalio/samples-php/tree/master/app/src/ActivityRetry) in the PHP samples repository. -### How to set the required Activity Timeouts {/* #required-timeout */} +### Set the required Activity Timeouts {/* #required-timeout */} Activity Execution semantics rely on several parameters. The only required value that needs to be set is either a [Schedule-To-Close Timeout](/encyclopedia/detecting-activity-failures#start-to-close-timeout) or a [Start-To-Close Timeout](/encyclopedia/detecting-activity-failures#start-to-close-timeout). These values are set in the Activity Options. -## Activity next Retry delay {/* #activity-next-retry-delay */} +## Activity next retry delay {/* #activity-next-retry-delay */} **How to override the next Retry delay following an Activity failure using the Temporal PHP SDK** @@ -96,7 +96,7 @@ throw new \Temporal\Exception\Failure\ApplicationFailure( ); ``` -## How to Heartbeat an Activity {/* #activity-heartbeats */} +## Heartbeat an Activity {/* #activity-heartbeats */} An [Activity Heartbeat](/encyclopedia/detecting-activity-failures#activity-heartbeat) is a ping from the [Worker Process](/workers#worker-process) that is executing the Activity to the [Temporal Service](/temporal-service). Each Heartbeat informs the Temporal Service that the [Activity Execution](/activity-execution) is making progress and the Worker has not crashed. @@ -151,7 +151,7 @@ class FileProcessingActivitiesImpl implements FileProcessingActivities } ``` -#### How to set a Heartbeat Timeout {/* #heartbeat-timeout */} +#### Set a Heartbeat Timeout {/* #heartbeat-timeout */} A [Heartbeat Timeout](/encyclopedia/detecting-activity-failures#heartbeat-timeout) works in conjunction with [Activity Heartbeats](/encyclopedia/detecting-activity-failures#activity-heartbeat). diff --git a/docs/develop/python/activities/asynchronous-activity.mdx b/docs/develop/python/activities/asynchronous-activity.mdx index 9049743422..fb5338589d 100644 --- a/docs/develop/python/activities/asynchronous-activity.mdx +++ b/docs/develop/python/activities/asynchronous-activity.mdx @@ -1,7 +1,7 @@ --- id: asynchronous-activity -title: Asynchronous Activity completion - Python SDK -sidebar_label: Asynchronous Activity completion +title: Asynchronous Activity Completion - Python SDK +sidebar_label: Asynchronous Activity Completion description: Asynchronously complete an Activity using the Temporal Python SDK. Follow three steps for Activity completion and use the Temporal Client for Heartbeat and updates. toc_max_heading_level: 2 tags: diff --git a/docs/develop/python/activities/basics.mdx b/docs/develop/python/activities/basics.mdx index 473bd2f252..43200a22ab 100644 --- a/docs/develop/python/activities/basics.mdx +++ b/docs/develop/python/activities/basics.mdx @@ -2,9 +2,10 @@ id: basics title: Activity basics - Python SDK sidebar_label: Activity basics -description: This section explains Activity Basics with the Python SDK +description: Define an Activity with the Temporal Python SDK, pass a single parameter object within Payload size limits, and customize the Activity Type name. toc_max_heading_level: 4 tags: + - Activities - Python SDK - Temporal SDKs --- @@ -56,7 +57,7 @@ async def your_activity(input: YourParams) -> str: return f"{input.greeting}, {input.name}!" ``` -### Develop Activity Parameters {/* #activity-parameters */} +### Develop Activity parameters {/* #activity-parameters */} There is no explicit limit to the total number of parameters that an [Activity Definition](/activity-definition) may support. However, there is a limit to the total size of the data that ends up encoded into a gRPC message Payload. diff --git a/docs/develop/python/activities/execution.mdx b/docs/develop/python/activities/execution.mdx index 61057a2889..4c6fddf4eb 100644 --- a/docs/develop/python/activities/execution.mdx +++ b/docs/develop/python/activities/execution.mdx @@ -1,14 +1,14 @@ --- id: execution title: Activity execution - Python SDK -description: Shows how to perform Activity execution with the Python SDK +description: Spawn an Activity Execution from a Workflow with the Temporal Python SDK, set the required Activity Timeouts, and get the Activity's result. sidebar_label: Activity execution slug: /develop/python/activities/execution toc_max_heading_level: 3 tags: + - Activities - Python SDK - Temporal SDKs - - Activity --- ## Start an Activity Execution {/* #activity-execution */} diff --git a/docs/develop/python/activities/index.mdx b/docs/develop/python/activities/index.mdx index 160ba1bd32..e300d89d0c 100644 --- a/docs/develop/python/activities/index.mdx +++ b/docs/develop/python/activities/index.mdx @@ -2,9 +2,10 @@ id: index title: Activities - Python SDK sidebar_label: Activities -description: This section explains how to implement Activities with the Python SDK +description: Define Activities, spawn Activity Executions, set Timeouts and Retry Policies, run Standalone Activities, and mark benign errors in Python. toc_max_heading_level: 4 tags: + - Activities - Python SDK - Temporal SDKs --- @@ -22,7 +23,7 @@ import * as Components from '@site/src/components'; - [Activity basics](/develop/python/activities/basics) - [Activity execution](/develop/python/activities/execution) - [Standalone Activities Quickstart](/develop/python/activities/standalone-activities-quickstart) -- [Standalone Activities Feature Guide](/develop/python/activities/standalone-activities) +- [Standalone Activities](/develop/python/activities/standalone-activities) - [Timeouts](/develop/python/activities/timeouts) -- [Asynchronous Activity completion](/develop/python/activities/asynchronous-activity) +- [Asynchronous Activity Completion](/develop/python/activities/asynchronous-activity) - [Benign exceptions](/develop/python/activities/benign-exceptions) diff --git a/docs/develop/python/activities/standalone-activities-quickstart.mdx b/docs/develop/python/activities/standalone-activities-quickstart.mdx index 1f8f0e87aa..fbf51dffb3 100644 --- a/docs/develop/python/activities/standalone-activities-quickstart.mdx +++ b/docs/develop/python/activities/standalone-activities-quickstart.mdx @@ -1,6 +1,6 @@ --- id: standalone-activities-quickstart -title: Standalone Activities Python Quickstart +title: Standalone Activities Quickstart - Python SDK sidebar_label: Quickstart description: Execute a Standalone Activity with the Temporal Python SDK without writing a Workflow. tags: diff --git a/docs/develop/python/activities/standalone-activities.mdx b/docs/develop/python/activities/standalone-activities.mdx index 5f06dffdd1..f8f47898cd 100644 --- a/docs/develop/python/activities/standalone-activities.mdx +++ b/docs/develop/python/activities/standalone-activities.mdx @@ -1,6 +1,6 @@ --- id: standalone-activities -title: Standalone Activities Feature Guide +title: Standalone Activities - Python SDK sidebar_label: Feature Guide toc_max_heading_level: 4 tags: diff --git a/docs/develop/python/activities/timeouts.mdx b/docs/develop/python/activities/timeouts.mdx index ddb7e1f352..59fa7c2acf 100644 --- a/docs/develop/python/activities/timeouts.mdx +++ b/docs/develop/python/activities/timeouts.mdx @@ -2,7 +2,7 @@ id: timeouts title: Activity Timeouts - Python SDK sidebar_label: Timeouts -description: Optimize Workflow Execution with Temporal Python SDK - Set Activity Timeouts and Retry Policies efficiently. +description: Set Activity Timeouts and a Retry Policy with the Temporal Python SDK, override the next retry delay, and Heartbeat long-running Activities. toc_max_heading_level: 4 tags: - Activities diff --git a/docs/develop/ruby/activities/asynchronous-activity.mdx b/docs/develop/ruby/activities/asynchronous-activity.mdx index 82e6d137b2..d19ec958da 100644 --- a/docs/develop/ruby/activities/asynchronous-activity.mdx +++ b/docs/develop/ruby/activities/asynchronous-activity.mdx @@ -1,7 +1,7 @@ --- id: asynchronous-activity -title: Asynchronous Activity completion - Ruby SDK -sidebar_label: Asynchronous Activity completion +title: Asynchronous Activity Completion - Ruby SDK +sidebar_label: Asynchronous Activity Completion description: Asynchronously complete an Activity in Temporal using the Ruby SDK. Follow simple steps to allow an Activity Function to return without the Activity Execution completing. toc_max_heading_level: 4 tags: @@ -10,7 +10,7 @@ tags: - Temporal SDKs --- -## How to asynchronously complete an Activity {/* #asynchronous-activity-completion */} +## Asynchronously complete an Activity {/* #asynchronous-activity-completion */} This page describes how to asynchronously complete an Activity. diff --git a/docs/develop/ruby/activities/basics.mdx b/docs/develop/ruby/activities/basics.mdx index 7bb439919d..aa19f1a1a5 100644 --- a/docs/develop/ruby/activities/basics.mdx +++ b/docs/develop/ruby/activities/basics.mdx @@ -2,9 +2,10 @@ id: basics title: Activity basics - Ruby SDK sidebar_label: Activity basics -description: This section explains Activity basics with the Ruby SDK +description: Define an Activity with the Temporal Ruby SDK, pass a single parameter object, and choose the thread pool or fiber executor that runs it. toc_max_heading_level: 4 tags: + - Activities - Ruby SDK - Temporal SDKs --- @@ -47,7 +48,7 @@ This is so that you can change what data is passed to the Activity without break The `execute` method in your Activity can technically accept multiple parameters of any data type that Temporal can convert. However, Temporal strongly encourages using a single parameter object to simplify versioning and maintainability. -### Activity Concurrency and Executors {/* #activity-concurrency-and-executors */} +### Activity concurrency and executors {/* #activity-concurrency-and-executors */} :::note diff --git a/docs/develop/ruby/activities/dynamic-activity.mdx b/docs/develop/ruby/activities/dynamic-activity.mdx index d8f76b2e46..882f870923 100644 --- a/docs/develop/ruby/activities/dynamic-activity.mdx +++ b/docs/develop/ruby/activities/dynamic-activity.mdx @@ -1,10 +1,11 @@ --- id: dynamic-activity -title: Dynamic Activities - Ruby SDK -sidebar_label: Dynamic Activities -description: This section explains Dynamic Activities with the Ruby SDK +title: Dynamic Activity - Ruby SDK +sidebar_label: Dynamic Activity +description: Register a Dynamic Activity with the Temporal Ruby SDK to handle Activity Types that no other registered Activity implementation matches. toc_max_heading_level: 4 tags: + - Activities - Ruby SDK - Temporal SDKs --- diff --git a/docs/develop/ruby/activities/execution.mdx b/docs/develop/ruby/activities/execution.mdx index 47fb8d88b4..ad0df39297 100644 --- a/docs/develop/ruby/activities/execution.mdx +++ b/docs/develop/ruby/activities/execution.mdx @@ -1,14 +1,14 @@ --- id: execution title: Activity execution - Ruby SDK -description: Shows how to perform Activity execution with the Ruby SDK +description: Spawn an Activity Execution from a Workflow with the Temporal Ruby SDK, set the required Activity Timeouts, and get the Activity's result. sidebar_label: Activity execution slug: /develop/ruby/activities/execution toc_max_heading_level: 3 tags: + - Activities - Ruby SDK - Temporal SDKs - - Activity --- ## Start Activity Execution {/* #activity-execution */} diff --git a/docs/develop/ruby/activities/index.mdx b/docs/develop/ruby/activities/index.mdx index 35a1aeef85..19b70fb3fe 100644 --- a/docs/develop/ruby/activities/index.mdx +++ b/docs/develop/ruby/activities/index.mdx @@ -2,9 +2,10 @@ id: index title: Activities - Ruby SDK sidebar_label: Activities -description: This section explains how to implement Activities with the Ruby SDK +description: Define Activities, spawn Activity Executions, set Timeouts and Retry Policies, run Standalone Activities, and mark benign errors in Ruby. toc_max_heading_level: 4 tags: + - Activities - Ruby SDK - Temporal SDKs --- @@ -22,8 +23,8 @@ import * as Components from '@site/src/components'; - [Activity basics](/develop/ruby/activities/basics) - [Activity execution](/develop/ruby/activities/execution) - [Standalone Activities Quickstart](/develop/ruby/activities/standalone-activities-quickstart) -- [Standalone Activities Feature Guide](/develop/ruby/activities/standalone-activities) +- [Standalone Activities](/develop/ruby/activities/standalone-activities) - [Timeouts](/develop/ruby/activities/timeouts) -- [Asynchronous Activity completion](/develop/ruby/activities/asynchronous-activity) +- [Asynchronous Activity Completion](/develop/ruby/activities/asynchronous-activity) - [Dynamic Activity](/develop/ruby/activities/dynamic-activity) - [Benign exceptions](/develop/ruby/activities/benign-exceptions) diff --git a/docs/develop/ruby/activities/standalone-activities-quickstart.mdx b/docs/develop/ruby/activities/standalone-activities-quickstart.mdx index 29764521d1..70b74d8b7f 100644 --- a/docs/develop/ruby/activities/standalone-activities-quickstart.mdx +++ b/docs/develop/ruby/activities/standalone-activities-quickstart.mdx @@ -1,6 +1,6 @@ --- id: standalone-activities-quickstart -title: Standalone Activities Ruby Quickstart +title: Standalone Activities Quickstart - Ruby SDK sidebar_label: Quickstart description: Execute a Standalone Activity with the Temporal Ruby SDK without writing a Workflow. tags: diff --git a/docs/develop/ruby/activities/standalone-activities.mdx b/docs/develop/ruby/activities/standalone-activities.mdx index 8ff5fe3b5e..9c12a96941 100644 --- a/docs/develop/ruby/activities/standalone-activities.mdx +++ b/docs/develop/ruby/activities/standalone-activities.mdx @@ -1,6 +1,6 @@ --- id: standalone-activities -title: Standalone Activities Feature Guide +title: Standalone Activities - Ruby SDK sidebar_label: Feature Guide toc_max_heading_level: 4 tags: diff --git a/docs/develop/ruby/activities/timeouts.mdx b/docs/develop/ruby/activities/timeouts.mdx index 07cb45fbba..2015c7731c 100644 --- a/docs/develop/ruby/activities/timeouts.mdx +++ b/docs/develop/ruby/activities/timeouts.mdx @@ -2,7 +2,7 @@ id: timeouts title: Activity Timeouts - Ruby SDK sidebar_label: Timeouts -description: Optimize Workflow Execution with Temporal Ruby SDK - Set Activity Timeouts and Retry Policies efficiently. +description: Set Activity Timeouts and a Retry Policy with the Temporal Ruby SDK, override the next retry delay, and Heartbeat long-running Activities. toc_max_heading_level: 4 tags: - Activities diff --git a/docs/develop/rust/activities/basics.mdx b/docs/develop/rust/activities/basics.mdx index 9d3c0203a7..03430a2988 100644 --- a/docs/develop/rust/activities/basics.mdx +++ b/docs/develop/rust/activities/basics.mdx @@ -2,9 +2,10 @@ id: basics title: Activity basics - Rust SDK sidebar_label: Activity basics -description: This section explains how to implement Activities with the Rust SDK +description: Define an Activity with the Temporal Rust SDK, pass a single parameter object within Payload size limits, and customize the Activity Type name. toc_max_heading_level: 4 tags: + - Activities - Rust SDK - Temporal SDKs --- diff --git a/docs/develop/rust/activities/execution.mdx b/docs/develop/rust/activities/execution.mdx index a052661e8f..886243bf6a 100644 --- a/docs/develop/rust/activities/execution.mdx +++ b/docs/develop/rust/activities/execution.mdx @@ -1,14 +1,14 @@ --- id: execution title: Activity execution - Rust SDK -description: Shows how to perform Activity execution with the Rust SDK +description: Spawn an Activity Execution from a Workflow with the Temporal Rust SDK, set the required Activity Timeouts, and get the Activity's result. sidebar_label: Activity execution slug: /develop/rust/activities/execution toc_max_heading_level: 3 tags: + - Activities - Rust SDK - Temporal SDKs - - Activity --- ## Start an Activity Execution {/* #activity-execution */} diff --git a/docs/develop/rust/activities/index.mdx b/docs/develop/rust/activities/index.mdx index 21a9f6a37d..0348ad8337 100644 --- a/docs/develop/rust/activities/index.mdx +++ b/docs/develop/rust/activities/index.mdx @@ -2,10 +2,10 @@ id: index title: Activities - Rust SDK sidebar_label: Activities -description: - This section explains how to implement Activities with the Rust SDK +description: Define Activities, spawn Activity Executions from a Workflow, and set Activity Timeouts, Retry Policies, and Heartbeats with the Temporal Rust SDK. toc_max_heading_level: 4 tags: + - Activities - Rust SDK - Temporal SDKs --- diff --git a/docs/develop/rust/activities/timeouts.mdx b/docs/develop/rust/activities/timeouts.mdx index 0e607ce5e0..21d33f8b1f 100644 --- a/docs/develop/rust/activities/timeouts.mdx +++ b/docs/develop/rust/activities/timeouts.mdx @@ -2,7 +2,7 @@ id: timeouts title: Activity Timeouts - Rust SDK sidebar_label: Timeouts -description: Optimize Workflow Execution with the Temporal Rust SDK by configuring Activity Timeouts, Retry Policies, and Heartbeats. +description: Set Activity Timeouts and a Retry Policy with the Temporal Rust SDK, override the next retry delay, and Heartbeat long-running Activities. toc_max_heading_level: 4 tags: - Activities @@ -103,7 +103,7 @@ impl TestGreetActivities { An [Activity Heartbeat](/encyclopedia/detecting-activity-failures#activity-heartbeat) is a signal from the [Worker Process](/workers#worker-process) executing the Activity to the [Temporal Service](/temporal-service). Each heartbeat tells the service that the [Activity Execution](/activity-execution) is still making progress and that the Worker has not crashed. If the service does not receive a heartbeat within the configured [Heartbeat Timeout](/encyclopedia/detecting-activity-failures#heartbeat-timeout), the Activity can time out and be retried according to its Retry Policy. -Heartbeats may be throttled by the Worker, so not every heartbeat call is necessarily sent immediately to the Temporal Service. Activity cancellation is also delivered through heartbeat processing, which means Activities that don't heartbeat cannot receive cancellation promptly. ([Temporal Docs][3]) +Heartbeats may be throttled by the Worker, so not every heartbeat call is necessarily sent immediately to the Temporal Service. Activity cancellation is also delivered through heartbeat processing, which means Activities that don't heartbeat cannot receive cancellation promptly. Heartbeats can include `details` that describe current progress. If the Activity fails and is retried, the retried attempt can retrieve the details from the most recently recorded heartbeat. The Rust SDK exposes activity context support for heartbeat details. diff --git a/docs/develop/typescript/activities/asynchronous-activity.mdx b/docs/develop/typescript/activities/asynchronous-activity.mdx index 6793d2a1af..315b39b9bb 100644 --- a/docs/develop/typescript/activities/asynchronous-activity.mdx +++ b/docs/develop/typescript/activities/asynchronous-activity.mdx @@ -1,7 +1,7 @@ --- id: asynchronous-activity -title: Asynchronous Activity - TypeScript SDK -sidebar_label: Asynchronous Activity +title: Asynchronous Activity Completion - TypeScript SDK +sidebar_label: Asynchronous Activity Completion slug: /develop/typescript/activities/asynchronous-activity toc_max_heading_level: 2 tags: @@ -11,7 +11,7 @@ tags: description: Asynchronously complete an Activity in Temporal by enabling the Activity Function to return before the Activity Execution finishes, using AsyncCompletionClient. --- -## How to asynchronously complete an Activity {/* #asynchronous-activity-completion */} +## Asynchronously complete an Activity {/* #asynchronous-activity-completion */} [Asynchronous Activity Completion](/activity-execution#asynchronous-activity-completion) enables the Activity Function to return without the Activity Execution completing. diff --git a/docs/develop/typescript/activities/basics.mdx b/docs/develop/typescript/activities/basics.mdx index d973b9bcbc..f1ab52ad35 100644 --- a/docs/develop/typescript/activities/basics.mdx +++ b/docs/develop/typescript/activities/basics.mdx @@ -1,17 +1,17 @@ --- id: basics title: Activity basics - TypeScript SDK -description: Shows how to create an Activity with the TypeScript SDK +description: Define an Activity with the Temporal TypeScript SDK, choose parameters and return values, and share dependencies across Activity functions. sidebar_label: Activity basics slug: /develop/typescript/activities/basics toc_max_heading_level: 3 tags: + - Activities - TypeScript SDK - Temporal SDKs - - Activity --- -## How to develop an Activity {/* #develop-activities */} +## Develop an Activity {/* #develop-activities */} One of the primary things that Workflows do is orchestrate the execution of Activities. An Activity is a normal function or method execution that's intended to execute a single, well-defined action (either short or long-running), such as @@ -38,7 +38,7 @@ export async function greet(name: string): Promise { ``` -## How to develop Activity Parameters {/* #activity-parameters */} +## Develop Activity parameters {/* #activity-parameters */} There is no explicit limit to the total number of parameters that an [Activity Definition](/activity-definition) may support. However, there is a limit to the total size of the data that ends up encoded into a gRPC message Payload. @@ -69,7 +69,7 @@ export async function greet(name: string): Promise { ``` -## How to define Activity return values {/* #activity-return-values */} +## Define Activity return values {/* #activity-return-values */} All data returned from an Activity must be serializable. @@ -88,7 +88,7 @@ export async function greet(name: string): Promise { } ``` -## How to customize your Activity Type {/* #activity-type */} +## Customize your Activity Type {/* #activity-type */} Activities have a Type that are referred to as the Activity name. The following examples demonstrate how to set a custom name for your Activity Type. diff --git a/docs/develop/typescript/activities/execution.mdx b/docs/develop/typescript/activities/execution.mdx index efe160684b..6cadbf2764 100644 --- a/docs/develop/typescript/activities/execution.mdx +++ b/docs/develop/typescript/activities/execution.mdx @@ -1,17 +1,17 @@ --- id: execution title: Activity execution - TypeScript SDK -description: Shows how to perform Activity execution with the TypeScript SDK +description: Spawn an Activity Execution from a Workflow with the Temporal TypeScript SDK, set the required Activity Timeouts, and get the Activity's result. sidebar_label: Activity execution slug: /develop/typescript/activities/execution toc_max_heading_level: 3 tags: + - Activities - TypeScript SDK - Temporal SDKs - - Activity --- -## How to start an Activity Execution {/* #activity-execution */} +## Start an Activity Execution {/* #activity-execution */} Calls to spawn [Activity Executions](/activity-execution) are written within a [Workflow Definition](/workflow-definition). In TypeScript, you never call an Activity function directly. Instead, you @@ -55,14 +55,14 @@ in and the value that comes back. This history is what allows Temporal to recove the entire history must be stored and replayed, avoid passing large objects as Activity inputs or return values. Keeping payloads small will help your Workflows replay and recover efficiently. ::: -## How to set the required Activity Timeouts {/* #required-timeout */} +## Set the required Activity Timeouts {/* #required-timeout */} Activity Execution semantics rely on several parameters. The only required value that needs to be set is either a [Schedule-To-Close Timeout](/encyclopedia/detecting-activity-failures#schedule-to-close-timeout) or a [Start-To-Close Timeout](/encyclopedia/detecting-activity-failures#start-to-close-timeout). These values are set in the Activity Options. -## How to get the results of an Activity Execution {/* #get-activity-results */} +## Get the results of an Activity Execution {/* #get-activity-results */} The call to spawn an [Activity Execution](/activity-execution) generates the [ScheduleActivityTask](/references/commands#scheduleactivitytask) Command and provides the Workflow with an Awaitable. diff --git a/docs/develop/typescript/activities/index.mdx b/docs/develop/typescript/activities/index.mdx index 293228e336..c847b92b6c 100644 --- a/docs/develop/typescript/activities/index.mdx +++ b/docs/develop/typescript/activities/index.mdx @@ -2,9 +2,10 @@ id: index title: Activities - TypeScript SDK sidebar_label: Activities -description: This section explains how to implement Activities with the TypeScript SDK +description: Define Activities, spawn Activity Executions, set Timeouts and Retry Policies, run Standalone Activities, and mark benign errors in TypeScript. toc_max_heading_level: 4 tags: + - Activities - TypeScript SDK - Temporal SDKs --- @@ -22,7 +23,7 @@ import * as Components from '@site/src/components'; - [Activity basics](/develop/typescript/activities/basics) - [Activity execution](/develop/typescript/activities/execution) - [Standalone Activities Quickstart](/develop/typescript/activities/standalone-activities-quickstart) -- [Standalone Activities Feature Guide](/develop/typescript/activities/standalone-activities) +- [Standalone Activities](/develop/typescript/activities/standalone-activities) - [Timeouts](/develop/typescript/activities/timeouts) -- [Asynchronous Activity](/develop/typescript/activities/asynchronous-activity) +- [Asynchronous Activity Completion](/develop/typescript/activities/asynchronous-activity) - [Benign exceptions](/develop/typescript/activities/benign-exceptions) diff --git a/docs/develop/typescript/activities/standalone-activities-quickstart.mdx b/docs/develop/typescript/activities/standalone-activities-quickstart.mdx index 0f26b866dc..13da901e62 100644 --- a/docs/develop/typescript/activities/standalone-activities-quickstart.mdx +++ b/docs/develop/typescript/activities/standalone-activities-quickstart.mdx @@ -1,6 +1,6 @@ --- id: standalone-activities-quickstart -title: Standalone Activities TypeScript Quickstart +title: Standalone Activities Quickstart - TypeScript SDK sidebar_label: Quickstart description: Execute a Standalone Activity with the Temporal TypeScript SDK without writing a Workflow. tags: diff --git a/docs/develop/typescript/activities/standalone-activities.mdx b/docs/develop/typescript/activities/standalone-activities.mdx index 330be0cc20..4a1962a94a 100644 --- a/docs/develop/typescript/activities/standalone-activities.mdx +++ b/docs/develop/typescript/activities/standalone-activities.mdx @@ -1,6 +1,6 @@ --- id: standalone-activities -title: Standalone Activities Feature Guide +title: Standalone Activities - TypeScript SDK sidebar_label: Feature Guide toc_max_heading_level: 4 tags: diff --git a/docs/develop/typescript/activities/timeouts.mdx b/docs/develop/typescript/activities/timeouts.mdx index 5ed7aae06d..0311cef177 100644 --- a/docs/develop/typescript/activities/timeouts.mdx +++ b/docs/develop/typescript/activities/timeouts.mdx @@ -2,7 +2,7 @@ id: timeouts title: Activity Timeouts - TypeScript SDK sidebar_label: Timeouts -description: Optimize Workflow Execution with Temporal TypeScript SDK - Set Activity Timeouts and Retry Policies efficiently. +description: Set Activity Timeouts and a Retry Policy with the Temporal TypeScript SDK, override the next retry delay, and Heartbeat long-running Activities. toc_max_heading_level: 4 tags: - Activities @@ -17,7 +17,7 @@ This page shows how to do the following: - [Activity Timeouts](#activity-timeouts) - [Activity Retry Policy](#activity-retries) -- [Activity next Retry delay](#activity-next-retry-delay) +- [Activity next retry delay](#activity-next-retry-delay) - [Heartbeat an Activity](#activity-heartbeats) - [Activity Heartbeat Timeout](#activity-heartbeat-timeout) @@ -69,7 +69,7 @@ const { myActivity } = proxyActivities({ }); ``` -## Activity next Retry delay {/* #activity-next-retry-delay */} +## Activity next retry delay {/* #activity-next-retry-delay */} **How to override the next Retry delay following an Activity failure using the Temporal TypeScript SDK** From bf2f303279ecff96ffca87e12da8ad9550d1255b Mon Sep 17 00:00:00 2001 From: Jwahir Sundai Date: Fri, 11 Sep 2026 14:05:08 -0500 Subject: [PATCH 2/7] edits --- .../dotnet/activities/asynchronous-activity.mdx | 4 ++-- docs/develop/dotnet/activities/basics.mdx | 2 +- .../dotnet/activities/benign-exceptions.mdx | 2 +- .../dotnet/activities/dynamic-activity.mdx | 2 +- docs/develop/dotnet/activities/execution.mdx | 2 +- docs/develop/dotnet/activities/index.mdx | 6 +++--- .../standalone-activities-quickstart.mdx | 2 +- .../dotnet/activities/standalone-activities.mdx | 2 +- docs/develop/dotnet/activities/timeouts.mdx | 2 +- .../go/activities/asynchronous-activity.mdx | 2 +- docs/develop/go/activities/basics.mdx | 2 +- docs/develop/go/activities/benign-exceptions.mdx | 2 +- docs/develop/go/activities/dynamic-activity.mdx | 2 +- docs/develop/go/activities/execution.mdx | 4 ++-- docs/develop/go/activities/index.mdx | 6 +++--- .../standalone-activities-quickstart.mdx | 2 +- .../go/activities/standalone-activities.mdx | 2 +- docs/develop/go/activities/timeouts.mdx | 2 +- .../java/activities/asynchronous-activity.mdx | 4 ++-- docs/develop/java/activities/basics.mdx | 2 +- .../java/activities/benign-exceptions.mdx | 2 +- docs/develop/java/activities/execution.mdx | 16 ++-------------- docs/develop/java/activities/index.mdx | 4 ++-- .../standalone-activities-quickstart.mdx | 2 +- .../java/activities/standalone-activities.mdx | 2 +- docs/develop/java/activities/timeouts.mdx | 2 +- docs/develop/php/activities/basics.mdx | 2 +- docs/develop/php/activities/execution.mdx | 4 ++-- docs/develop/php/activities/index.mdx | 2 +- docs/develop/php/activities/timeouts.mdx | 4 ++-- .../python/activities/asynchronous-activity.mdx | 4 ++-- docs/develop/python/activities/basics.mdx | 2 +- .../python/activities/benign-exceptions.mdx | 2 +- docs/develop/python/activities/execution.mdx | 2 +- docs/develop/python/activities/index.mdx | 6 +++--- .../standalone-activities-quickstart.mdx | 2 +- .../python/activities/standalone-activities.mdx | 2 +- docs/develop/python/activities/timeouts.mdx | 4 ++-- .../ruby/activities/asynchronous-activity.mdx | 4 ++-- docs/develop/ruby/activities/basics.mdx | 2 +- .../ruby/activities/benign-exceptions.mdx | 2 +- .../develop/ruby/activities/dynamic-activity.mdx | 6 +++--- docs/develop/ruby/activities/execution.mdx | 2 +- docs/develop/ruby/activities/index.mdx | 6 +++--- .../standalone-activities-quickstart.mdx | 2 +- .../ruby/activities/standalone-activities.mdx | 2 +- docs/develop/ruby/activities/timeouts.mdx | 2 +- docs/develop/rust/activities/basics.mdx | 2 +- docs/develop/rust/activities/execution.mdx | 2 +- docs/develop/rust/activities/index.mdx | 3 ++- docs/develop/rust/activities/timeouts.mdx | 2 +- .../activities/asynchronous-activity.mdx | 4 ++-- docs/develop/typescript/activities/basics.mdx | 2 +- .../typescript/activities/benign-exceptions.mdx | 2 +- docs/develop/typescript/activities/execution.mdx | 10 +++++++--- docs/develop/typescript/activities/index.mdx | 6 +++--- .../standalone-activities-quickstart.mdx | 2 +- .../activities/standalone-activities.mdx | 2 +- docs/develop/typescript/activities/timeouts.mdx | 2 +- 59 files changed, 89 insertions(+), 96 deletions(-) diff --git a/docs/develop/dotnet/activities/asynchronous-activity.mdx b/docs/develop/dotnet/activities/asynchronous-activity.mdx index 6f4879314f..cf884bf7c8 100644 --- a/docs/develop/dotnet/activities/asynchronous-activity.mdx +++ b/docs/develop/dotnet/activities/asynchronous-activity.mdx @@ -1,7 +1,7 @@ --- id: asynchronous-activity -title: Asynchronous Activity Completion - .NET SDK -sidebar_label: Asynchronous Activity Completion +title: Asynchronous Activity completion - .NET SDK +sidebar_label: Asynchronous Activity completion description: Asynchronously complete an Activity in Temporal. Follow simple steps to allow an Activity Function to return without the Activity Execution completing. toc_max_heading_level: 4 tags: diff --git a/docs/develop/dotnet/activities/basics.mdx b/docs/develop/dotnet/activities/basics.mdx index 6a0e10967a..05f2d0a7c2 100644 --- a/docs/develop/dotnet/activities/basics.mdx +++ b/docs/develop/dotnet/activities/basics.mdx @@ -2,7 +2,7 @@ id: basics title: Activity basics - .NET SDK sidebar_label: Activity basics -description: Define an Activity with the Temporal .NET SDK, pass a single parameter object within Payload size limits, and customize the Activity Type name. +description: This section explains Activity basics with the .NET SDK toc_max_heading_level: 4 tags: - Activities diff --git a/docs/develop/dotnet/activities/benign-exceptions.mdx b/docs/develop/dotnet/activities/benign-exceptions.mdx index bbae2c3fb6..77cdf0fa8d 100644 --- a/docs/develop/dotnet/activities/benign-exceptions.mdx +++ b/docs/develop/dotnet/activities/benign-exceptions.mdx @@ -2,7 +2,7 @@ id: benign-exceptions title: Benign exceptions - .NET SDK sidebar_label: Benign exceptions -description: Mark expected or non-severe Activity errors as benign to reduce noise in logs, metrics, and OpenTelemetry traces. +description: Mark expected or non-severe Activity errors as benign in .NET to reduce noise in logs, metrics, and OpenTelemetry traces. toc_max_heading_level: 2 tags: - Activities diff --git a/docs/develop/dotnet/activities/dynamic-activity.mdx b/docs/develop/dotnet/activities/dynamic-activity.mdx index 87f7a6795b..3ff60e6c49 100644 --- a/docs/develop/dotnet/activities/dynamic-activity.mdx +++ b/docs/develop/dotnet/activities/dynamic-activity.mdx @@ -2,7 +2,7 @@ id: dynamic-activity title: Dynamic Activity - .NET SDK sidebar_label: Dynamic Activity -description: Register a Dynamic Activity with the Temporal .NET SDK to handle Activity Types that no other registered Activity implementation matches. +description: This section explains Dynamic Activities with the .NET SDK toc_max_heading_level: 4 tags: - Activities diff --git a/docs/develop/dotnet/activities/execution.mdx b/docs/develop/dotnet/activities/execution.mdx index 23bbfe7469..bc7be9cf5b 100644 --- a/docs/develop/dotnet/activities/execution.mdx +++ b/docs/develop/dotnet/activities/execution.mdx @@ -1,7 +1,7 @@ --- id: execution title: Activity execution - .NET SDK -description: Spawn an Activity Execution from a Workflow with the Temporal .NET SDK, set the required Activity Timeouts, and get the Activity's result. +description: Shows how to perform Activity execution with the .NET SDK sidebar_label: Activity execution slug: /develop/dotnet/activities/execution toc_max_heading_level: 3 diff --git a/docs/develop/dotnet/activities/index.mdx b/docs/develop/dotnet/activities/index.mdx index 81214eb2b1..da386b5744 100644 --- a/docs/develop/dotnet/activities/index.mdx +++ b/docs/develop/dotnet/activities/index.mdx @@ -2,7 +2,7 @@ id: index title: Activities - .NET SDK sidebar_label: Activities -description: Define Activities, spawn Activity Executions, set Timeouts and Retry Policies, run Standalone Activities, and mark benign errors in .NET. +description: This section explains how to implement Activities with the .NET SDK toc_max_heading_level: 4 tags: - Activities @@ -23,8 +23,8 @@ import * as Components from '@site/src/components'; - [Activity basics](/develop/dotnet/activities/basics) - [Activity execution](/develop/dotnet/activities/execution) - [Standalone Activities Quickstart](/develop/dotnet/activities/standalone-activities-quickstart) -- [Standalone Activities](/develop/dotnet/activities/standalone-activities) +- [Standalone Activities Feature Guide](/develop/dotnet/activities/standalone-activities) - [Timeouts](/develop/dotnet/activities/timeouts) -- [Asynchronous Activity Completion](/develop/dotnet/activities/asynchronous-activity) +- [Asynchronous Activity completion](/develop/dotnet/activities/asynchronous-activity) - [Dynamic Activity](/develop/dotnet/activities/dynamic-activity) - [Benign exceptions](/develop/dotnet/activities/benign-exceptions) diff --git a/docs/develop/dotnet/activities/standalone-activities-quickstart.mdx b/docs/develop/dotnet/activities/standalone-activities-quickstart.mdx index bb8b0539a5..76dd0ac62c 100644 --- a/docs/develop/dotnet/activities/standalone-activities-quickstart.mdx +++ b/docs/develop/dotnet/activities/standalone-activities-quickstart.mdx @@ -1,6 +1,6 @@ --- id: standalone-activities-quickstart -title: Standalone Activities Quickstart - .NET SDK +title: Standalone Activities .NET Quickstart sidebar_label: Quickstart description: Execute a Standalone Activity with the Temporal .NET SDK without writing a Workflow. tags: diff --git a/docs/develop/dotnet/activities/standalone-activities.mdx b/docs/develop/dotnet/activities/standalone-activities.mdx index c88de6d83d..da70f9028d 100644 --- a/docs/develop/dotnet/activities/standalone-activities.mdx +++ b/docs/develop/dotnet/activities/standalone-activities.mdx @@ -1,6 +1,6 @@ --- id: standalone-activities -title: Standalone Activities - .NET SDK +title: Standalone Activities Feature Guide sidebar_label: Feature Guide toc_max_heading_level: 4 tags: diff --git a/docs/develop/dotnet/activities/timeouts.mdx b/docs/develop/dotnet/activities/timeouts.mdx index df48f9514c..2ab6cebd16 100644 --- a/docs/develop/dotnet/activities/timeouts.mdx +++ b/docs/develop/dotnet/activities/timeouts.mdx @@ -2,7 +2,7 @@ id: timeouts title: Activity Timeouts - .NET SDK sidebar_label: Timeouts -description: Set Activity Timeouts and a Retry Policy with the Temporal .NET SDK, override the next retry delay, and Heartbeat long-running Activities. +description: Set the Schedule-To-Close, Start-To-Close, and Heartbeat Timeouts on a .NET Activity, tune its Retry Policy, and override the next retry delay. toc_max_heading_level: 4 tags: - Activities diff --git a/docs/develop/go/activities/asynchronous-activity.mdx b/docs/develop/go/activities/asynchronous-activity.mdx index 8458623988..c2b891e8ed 100644 --- a/docs/develop/go/activities/asynchronous-activity.mdx +++ b/docs/develop/go/activities/asynchronous-activity.mdx @@ -1,6 +1,6 @@ --- id: asynchronous-activity -title: Asynchronous Activity Completion - Go SDK +title: Asynchronous Activity completion - Go SDK sidebar_label: Asynchronous Activity Completion toc_max_heading_level: 4 tags: diff --git a/docs/develop/go/activities/basics.mdx b/docs/develop/go/activities/basics.mdx index 9e6785386c..10dbc8bbcf 100644 --- a/docs/develop/go/activities/basics.mdx +++ b/docs/develop/go/activities/basics.mdx @@ -2,7 +2,7 @@ id: basics title: Activity basics - Go SDK sidebar_label: Activity basics -description: Define an Activity with the Temporal Go SDK, pass a single parameter object within Payload size limits, and customize the Activity Type name. +description: This section explains Activity basics with the Go SDK toc_max_heading_level: 4 tags: - Activities diff --git a/docs/develop/go/activities/benign-exceptions.mdx b/docs/develop/go/activities/benign-exceptions.mdx index b2086d6d5c..1e53598528 100644 --- a/docs/develop/go/activities/benign-exceptions.mdx +++ b/docs/develop/go/activities/benign-exceptions.mdx @@ -2,7 +2,7 @@ id: benign-exceptions title: Benign exceptions - Go SDK sidebar_label: Benign exceptions -description: Mark expected or non-severe Activity errors as benign to reduce noise in logs, metrics, and OpenTelemetry traces. +description: Mark expected or non-severe Activity errors as benign in Go to reduce noise in logs, metrics, and OpenTelemetry traces. toc_max_heading_level: 2 tags: - Activities diff --git a/docs/develop/go/activities/dynamic-activity.mdx b/docs/develop/go/activities/dynamic-activity.mdx index 16feeadcb3..6ab7929186 100644 --- a/docs/develop/go/activities/dynamic-activity.mdx +++ b/docs/develop/go/activities/dynamic-activity.mdx @@ -2,7 +2,7 @@ id: dynamic-activity title: Dynamic Activity - Go SDK sidebar_label: Dynamic Activity -description: Register a Dynamic Activity with the Temporal Go SDK to handle Activity Types that no other registered Activity implementation matches. +description: This section explains Dynamic Activities with the Go SDK toc_max_heading_level: 4 tags: - Activities diff --git a/docs/develop/go/activities/execution.mdx b/docs/develop/go/activities/execution.mdx index e493ad0213..8daf5c401a 100644 --- a/docs/develop/go/activities/execution.mdx +++ b/docs/develop/go/activities/execution.mdx @@ -1,8 +1,8 @@ --- id: execution title: Activity execution - Go SDK -description: Spawn an Activity Execution from a Go Workflow, get its result, and set every ActivityOptions field, from Timeouts and Task Queue to Retry Policy. -sidebar_label: Activity execution +description: Shows how to perform Activity execution with the Go SDK +sidebar_label: Activity Execution slug: /develop/go/activities/execution toc_max_heading_level: 3 tags: diff --git a/docs/develop/go/activities/index.mdx b/docs/develop/go/activities/index.mdx index 7786a4c58b..5370de47c0 100644 --- a/docs/develop/go/activities/index.mdx +++ b/docs/develop/go/activities/index.mdx @@ -2,7 +2,7 @@ id: index title: Activities - Go SDK sidebar_label: Activities -description: Define Activities, spawn Activity Executions, set Timeouts and Retry Policies, run Standalone Activities, and mark benign errors in Go. +description: This section explains how to implement Activities with the Go SDK toc_max_heading_level: 4 tags: - Activities @@ -23,8 +23,8 @@ import * as Components from '@site/src/components'; - [Activity basics](/develop/go/activities/basics) - [Activity execution](/develop/go/activities/execution) - [Standalone Activities Quickstart](/develop/go/activities/standalone-activities-quickstart) -- [Standalone Activities](/develop/go/activities/standalone-activities) +- [Standalone Activities Feature Guide](/develop/go/activities/standalone-activities) - [Timeouts](/develop/go/activities/timeouts) -- [Asynchronous Activity Completion](/develop/go/activities/asynchronous-activity) +- [Asynchronous Activity completion](/develop/go/activities/asynchronous-activity) - [Dynamic Activity](/develop/go/activities/dynamic-activity) - [Benign exceptions](/develop/go/activities/benign-exceptions) diff --git a/docs/develop/go/activities/standalone-activities-quickstart.mdx b/docs/develop/go/activities/standalone-activities-quickstart.mdx index 4084b3d082..c18f88311b 100644 --- a/docs/develop/go/activities/standalone-activities-quickstart.mdx +++ b/docs/develop/go/activities/standalone-activities-quickstart.mdx @@ -1,6 +1,6 @@ --- id: standalone-activities-quickstart -title: Standalone Activities Quickstart - Go SDK +title: Standalone Activities Go Quickstart sidebar_label: Quickstart description: Execute a Standalone Activity with the Temporal Go SDK without writing a Workflow. tags: diff --git a/docs/develop/go/activities/standalone-activities.mdx b/docs/develop/go/activities/standalone-activities.mdx index 35c0366d15..62fbbb662c 100644 --- a/docs/develop/go/activities/standalone-activities.mdx +++ b/docs/develop/go/activities/standalone-activities.mdx @@ -1,6 +1,6 @@ --- id: standalone-activities -title: Standalone Activities - Go SDK +title: Standalone Activities Feature Guide sidebar_label: Feature Guide toc_max_heading_level: 4 tags: diff --git a/docs/develop/go/activities/timeouts.mdx b/docs/develop/go/activities/timeouts.mdx index 2b8e313bb4..076db36bd8 100644 --- a/docs/develop/go/activities/timeouts.mdx +++ b/docs/develop/go/activities/timeouts.mdx @@ -2,7 +2,7 @@ id: timeouts title: Activity Timeouts - Go SDK sidebar_label: Timeouts -description: Set Activity Timeouts and a Retry Policy with the Temporal Go SDK, override the next retry delay, and Heartbeat long-running Activities. +description: Set the Schedule-To-Close, Start-To-Close, and Heartbeat Timeouts on a Go Activity, tune its Retry Policy, and override the next retry delay. toc_max_heading_level: 4 tags: - Activities diff --git a/docs/develop/java/activities/asynchronous-activity.mdx b/docs/develop/java/activities/asynchronous-activity.mdx index 87263fc4f9..6166efe50f 100644 --- a/docs/develop/java/activities/asynchronous-activity.mdx +++ b/docs/develop/java/activities/asynchronous-activity.mdx @@ -1,7 +1,7 @@ --- id: asynchronous-activity -title: Asynchronous Activity Completion - Java SDK -sidebar_label: Asynchronous Activity Completion +title: Asynchronous Activity completion - Java SDK +sidebar_label: Asynchronous Activity completion toc_max_heading_level: 4 tags: - Activities diff --git a/docs/develop/java/activities/basics.mdx b/docs/develop/java/activities/basics.mdx index a16dfcb091..4a90db5af2 100644 --- a/docs/develop/java/activities/basics.mdx +++ b/docs/develop/java/activities/basics.mdx @@ -2,7 +2,7 @@ id: basics title: Activity basics - Java SDK sidebar_label: Activity basics -description: Define an Activity with the Temporal Java SDK, pass a single parameter object within Payload size limits, and customize the Activity Type name. +description: This section explains Activity basics with the Java SDK toc_max_heading_level: 4 tags: - Activities diff --git a/docs/develop/java/activities/benign-exceptions.mdx b/docs/develop/java/activities/benign-exceptions.mdx index 01d1b2a246..ce5ed003c7 100644 --- a/docs/develop/java/activities/benign-exceptions.mdx +++ b/docs/develop/java/activities/benign-exceptions.mdx @@ -2,7 +2,7 @@ id: benign-exceptions title: Benign exceptions - Java SDK sidebar_label: Benign exceptions -description: Mark expected or non-severe Activity errors as benign to reduce noise in logs, metrics, and OpenTelemetry traces. +description: Mark expected or non-severe Activity errors as benign in Java to reduce noise in logs, metrics, and OpenTelemetry traces. toc_max_heading_level: 2 tags: - Activities diff --git a/docs/develop/java/activities/execution.mdx b/docs/develop/java/activities/execution.mdx index 1f916aea11..fafbc700fd 100644 --- a/docs/develop/java/activities/execution.mdx +++ b/docs/develop/java/activities/execution.mdx @@ -1,8 +1,8 @@ --- id: execution title: Activity execution - Java SDK -description: Invoke Activities synchronously or asynchronously from a Java Workflow, set ActivityOptions and Timeouts, and read the ActivityExecutionContext. -sidebar_label: Activity execution +description: Shows how to perform Activity execution with the Java SDK +sidebar_label: Activity Execution slug: /develop/java/activities/execution toc_max_heading_level: 3 tags: @@ -292,9 +292,6 @@ This or `StartToCloseTimeout` must be set. - Default: Unlimited. Note that if `WorkflowRunTimeout` and/or `WorkflowExecutionTimeout` are defined in the Workflow, all Activity retries will stop when either or both of these timeouts are reached. -You can set Activity Options using an `ActivityStub` within a Workflow implementation, or per-Activity using `WorkflowImplementationOptions` within a Worker. -Note that if you define options per-Activity Type options with `WorkflowImplementationOptions.setActivityOptions()`, setting them again specifically with `ActivityStub` in a Workflow will override this setting. - - With `ActivityStub` ```java @@ -325,9 +322,6 @@ To set a [Schedule-To-Start Timeout](/encyclopedia/detecting-activity-failures#s - Type: `Duration` - Default: Unlimited. This timeout is non-retryable. -You can set Activity Options using an `ActivityStub` within a Workflow implementation, or per-Activity using `WorkflowImplementationOptions` within a Worker. -Note that if you define options per-Activity Type options with `WorkflowImplementationOptions.setActivityOptions()`, setting them again specifically with `ActivityStub` in a Workflow will override this setting. - - With `ActivityStub` ```java @@ -363,9 +357,6 @@ This or `ScheduleToClose` must be set. - Type: `Duration` - Default: Defaults to [`ScheduleToCloseTimeout`](#scheduletoclosetimeout) value -You can set Activity Options using an `ActivityStub` within a Workflow implementation, or per-Activity using `WorkflowImplementationOptions` within a Worker. -Note that if you define options per-Activity Type options with `WorkflowImplementationOptions.setActivityOptions()`, setting them again specifically with `ActivityStub` in a Workflow will override this setting. - - With `ActivityStub` ```java @@ -397,9 +388,6 @@ To set a [Heartbeat Timeout](/encyclopedia/detecting-activity-failures#heartbeat - Type: `Duration` - Default: None -You can set Activity Options using an `ActivityStub` within a Workflow implementation, or per-Activity using `WorkflowImplementationOptions` within a Worker. -Note that if you define options per-Activity Type options with `WorkflowImplementationOptions.setActivityOptions()`, setting them again specifically with `ActivityStub` in a Workflow will override this setting. - - With `ActivityStub` ```java diff --git a/docs/develop/java/activities/index.mdx b/docs/develop/java/activities/index.mdx index 5979c98b75..8e2fb0b478 100644 --- a/docs/develop/java/activities/index.mdx +++ b/docs/develop/java/activities/index.mdx @@ -2,7 +2,7 @@ id: index title: Activities - Java SDK sidebar_label: Activities -description: Define Activities, spawn Activity Executions, set Timeouts and Retry Policies, run Standalone Activities, and mark benign errors in Java. +description: This section explains how to implement Activities with the Java SDK toc_max_heading_level: 4 tags: - Activities @@ -23,7 +23,7 @@ import * as Components from '@site/src/components'; - [Activity basics](/develop/java/activities/basics) - [Activity execution](/develop/java/activities/execution) - [Standalone Activities Quickstart](/develop/java/activities/standalone-activities-quickstart) -- [Standalone Activities](/develop/java/activities/standalone-activities) +- [Standalone Activities Feature Guide](/develop/java/activities/standalone-activities) - [Timeouts](/develop/java/activities/timeouts) - [Asynchronous Activity Completion](/develop/java/activities/asynchronous-activity) - [Benign exceptions](/develop/java/activities/benign-exceptions) diff --git a/docs/develop/java/activities/standalone-activities-quickstart.mdx b/docs/develop/java/activities/standalone-activities-quickstart.mdx index 2d0822e3b9..5ed927d359 100644 --- a/docs/develop/java/activities/standalone-activities-quickstart.mdx +++ b/docs/develop/java/activities/standalone-activities-quickstart.mdx @@ -1,6 +1,6 @@ --- id: standalone-activities-quickstart -title: Standalone Activities Quickstart - Java SDK +title: Standalone Activities Java Quickstart sidebar_label: Quickstart description: Execute a Standalone Activity with the Temporal Java SDK without writing a Workflow. tags: diff --git a/docs/develop/java/activities/standalone-activities.mdx b/docs/develop/java/activities/standalone-activities.mdx index 399fc1e513..24d316b4f8 100644 --- a/docs/develop/java/activities/standalone-activities.mdx +++ b/docs/develop/java/activities/standalone-activities.mdx @@ -1,6 +1,6 @@ --- id: standalone-activities -title: Standalone Activities - Java SDK +title: Standalone Activities Feature Guide sidebar_label: Feature Guide toc_max_heading_level: 4 tags: diff --git a/docs/develop/java/activities/timeouts.mdx b/docs/develop/java/activities/timeouts.mdx index 928972bb5c..49a3c022ff 100644 --- a/docs/develop/java/activities/timeouts.mdx +++ b/docs/develop/java/activities/timeouts.mdx @@ -2,7 +2,7 @@ id: timeouts title: Activity Timeouts - Java SDK sidebar_label: Timeouts -description: Set Activity Timeouts and a Retry Policy with the Temporal Java SDK, override the next retry delay, and Heartbeat long-running Activities. +description: This section explains how to set Activity Timeouts with the Java SDK toc_max_heading_level: 4 tags: - Activities diff --git a/docs/develop/php/activities/basics.mdx b/docs/develop/php/activities/basics.mdx index d58ff8121b..7e24526db6 100644 --- a/docs/develop/php/activities/basics.mdx +++ b/docs/develop/php/activities/basics.mdx @@ -2,7 +2,7 @@ id: basics title: Activity basics - PHP SDK sidebar_label: Activity basics -description: Define an Activity with the Temporal PHP SDK, pass a single parameter object within Payload size limits, and customize the Activity Type name. +description: This section explains Activity basics with the PHP SDK toc_max_heading_level: 4 tags: - Activities diff --git a/docs/develop/php/activities/execution.mdx b/docs/develop/php/activities/execution.mdx index b74648491d..63bda7f690 100644 --- a/docs/develop/php/activities/execution.mdx +++ b/docs/develop/php/activities/execution.mdx @@ -1,8 +1,8 @@ --- id: execution title: Activity execution - PHP SDK -description: Spawn an Activity Execution from a Workflow with the Temporal PHP SDK, set the required Activity Timeouts, and get the Activity's result. -sidebar_label: Activity execution +description: Shows how to perform Activity execution with the PHP SDK +sidebar_label: Activity Execution slug: /develop/php/activities/execution toc_max_heading_level: 3 tags: diff --git a/docs/develop/php/activities/index.mdx b/docs/develop/php/activities/index.mdx index f259ccb6f0..7044c23dbe 100644 --- a/docs/develop/php/activities/index.mdx +++ b/docs/develop/php/activities/index.mdx @@ -2,7 +2,7 @@ id: index title: Activities - PHP SDK sidebar_label: Activities -description: Define Activities, spawn Activity Executions from a Workflow, set Activity Timeouts and Retry Policies, and complete Activities asynchronously in PHP. +description: This section explains how to implement Activities with the PHP SDK toc_max_heading_level: 4 tags: - Activities diff --git a/docs/develop/php/activities/timeouts.mdx b/docs/develop/php/activities/timeouts.mdx index 2afd1d0e26..28b6e6e904 100644 --- a/docs/develop/php/activities/timeouts.mdx +++ b/docs/develop/php/activities/timeouts.mdx @@ -2,7 +2,7 @@ id: timeouts title: Activity Timeouts - PHP SDK sidebar_label: Timeouts -description: Set Activity Timeouts and a Retry Policy with the Temporal PHP SDK, override the next retry delay, and Heartbeat long-running Activities. +description: Set the Schedule-To-Close, Start-To-Close, and Heartbeat Timeouts on a PHP Activity, tune its Retry Policy, and override the next retry delay. toc_max_heading_level: 4 tags: - Activities @@ -151,7 +151,7 @@ class FileProcessingActivitiesImpl implements FileProcessingActivities } ``` -#### Set a Heartbeat Timeout {/* #heartbeat-timeout */} +### Set a Heartbeat Timeout {/* #heartbeat-timeout */} A [Heartbeat Timeout](/encyclopedia/detecting-activity-failures#heartbeat-timeout) works in conjunction with [Activity Heartbeats](/encyclopedia/detecting-activity-failures#activity-heartbeat). diff --git a/docs/develop/python/activities/asynchronous-activity.mdx b/docs/develop/python/activities/asynchronous-activity.mdx index fb5338589d..9049743422 100644 --- a/docs/develop/python/activities/asynchronous-activity.mdx +++ b/docs/develop/python/activities/asynchronous-activity.mdx @@ -1,7 +1,7 @@ --- id: asynchronous-activity -title: Asynchronous Activity Completion - Python SDK -sidebar_label: Asynchronous Activity Completion +title: Asynchronous Activity completion - Python SDK +sidebar_label: Asynchronous Activity completion description: Asynchronously complete an Activity using the Temporal Python SDK. Follow three steps for Activity completion and use the Temporal Client for Heartbeat and updates. toc_max_heading_level: 2 tags: diff --git a/docs/develop/python/activities/basics.mdx b/docs/develop/python/activities/basics.mdx index 43200a22ab..67441835f1 100644 --- a/docs/develop/python/activities/basics.mdx +++ b/docs/develop/python/activities/basics.mdx @@ -2,7 +2,7 @@ id: basics title: Activity basics - Python SDK sidebar_label: Activity basics -description: Define an Activity with the Temporal Python SDK, pass a single parameter object within Payload size limits, and customize the Activity Type name. +description: This section explains Activity basics with the Python SDK toc_max_heading_level: 4 tags: - Activities diff --git a/docs/develop/python/activities/benign-exceptions.mdx b/docs/develop/python/activities/benign-exceptions.mdx index 746bb4fde3..87946ad82b 100644 --- a/docs/develop/python/activities/benign-exceptions.mdx +++ b/docs/develop/python/activities/benign-exceptions.mdx @@ -2,7 +2,7 @@ id: benign-exceptions title: Benign exceptions - Python SDK sidebar_label: Benign exceptions -description: Mark expected or non-severe Activity errors as benign to reduce noise in logs, metrics, and OpenTelemetry traces. +description: Mark expected or non-severe Activity errors as benign in Python to reduce noise in logs, metrics, and OpenTelemetry traces. toc_max_heading_level: 2 tags: - Activities diff --git a/docs/develop/python/activities/execution.mdx b/docs/develop/python/activities/execution.mdx index 4c6fddf4eb..f80f4c57f3 100644 --- a/docs/develop/python/activities/execution.mdx +++ b/docs/develop/python/activities/execution.mdx @@ -1,7 +1,7 @@ --- id: execution title: Activity execution - Python SDK -description: Spawn an Activity Execution from a Workflow with the Temporal Python SDK, set the required Activity Timeouts, and get the Activity's result. +description: Shows how to perform Activity execution with the Python SDK sidebar_label: Activity execution slug: /develop/python/activities/execution toc_max_heading_level: 3 diff --git a/docs/develop/python/activities/index.mdx b/docs/develop/python/activities/index.mdx index e300d89d0c..f4a4c0f496 100644 --- a/docs/develop/python/activities/index.mdx +++ b/docs/develop/python/activities/index.mdx @@ -2,7 +2,7 @@ id: index title: Activities - Python SDK sidebar_label: Activities -description: Define Activities, spawn Activity Executions, set Timeouts and Retry Policies, run Standalone Activities, and mark benign errors in Python. +description: This section explains how to implement Activities with the Python SDK toc_max_heading_level: 4 tags: - Activities @@ -23,7 +23,7 @@ import * as Components from '@site/src/components'; - [Activity basics](/develop/python/activities/basics) - [Activity execution](/develop/python/activities/execution) - [Standalone Activities Quickstart](/develop/python/activities/standalone-activities-quickstart) -- [Standalone Activities](/develop/python/activities/standalone-activities) +- [Standalone Activities Feature Guide](/develop/python/activities/standalone-activities) - [Timeouts](/develop/python/activities/timeouts) -- [Asynchronous Activity Completion](/develop/python/activities/asynchronous-activity) +- [Asynchronous Activity completion](/develop/python/activities/asynchronous-activity) - [Benign exceptions](/develop/python/activities/benign-exceptions) diff --git a/docs/develop/python/activities/standalone-activities-quickstart.mdx b/docs/develop/python/activities/standalone-activities-quickstart.mdx index fbf51dffb3..1f8f0e87aa 100644 --- a/docs/develop/python/activities/standalone-activities-quickstart.mdx +++ b/docs/develop/python/activities/standalone-activities-quickstart.mdx @@ -1,6 +1,6 @@ --- id: standalone-activities-quickstart -title: Standalone Activities Quickstart - Python SDK +title: Standalone Activities Python Quickstart sidebar_label: Quickstart description: Execute a Standalone Activity with the Temporal Python SDK without writing a Workflow. tags: diff --git a/docs/develop/python/activities/standalone-activities.mdx b/docs/develop/python/activities/standalone-activities.mdx index f8f47898cd..5f06dffdd1 100644 --- a/docs/develop/python/activities/standalone-activities.mdx +++ b/docs/develop/python/activities/standalone-activities.mdx @@ -1,6 +1,6 @@ --- id: standalone-activities -title: Standalone Activities - Python SDK +title: Standalone Activities Feature Guide sidebar_label: Feature Guide toc_max_heading_level: 4 tags: diff --git a/docs/develop/python/activities/timeouts.mdx b/docs/develop/python/activities/timeouts.mdx index 59fa7c2acf..f70b904ae1 100644 --- a/docs/develop/python/activities/timeouts.mdx +++ b/docs/develop/python/activities/timeouts.mdx @@ -2,7 +2,7 @@ id: timeouts title: Activity Timeouts - Python SDK sidebar_label: Timeouts -description: Set Activity Timeouts and a Retry Policy with the Temporal Python SDK, override the next retry delay, and Heartbeat long-running Activities. +description: Set the Schedule-To-Close, Start-To-Close, and Heartbeat Timeouts on a Python Activity, tune its Retry Policy, and override the next retry delay. toc_max_heading_level: 4 tags: - Activities @@ -144,7 +144,7 @@ async def your_activity_definition() -> str: In addition to obtaining cancellation information, Heartbeats also support detail data that persists on the server for retrieval during Activity retry. If an Activity calls `heartbeat(123, 456)` and then fails and is retried, `heartbeat_details` returns an iterable containing `123` and `456` on the next Run. -#### Set a Heartbeat Timeout {/* #heartbeat-timeout */} +### Set a Heartbeat Timeout {/* #heartbeat-timeout */} A [Heartbeat Timeout](/encyclopedia/detecting-activity-failures#heartbeat-timeout) works in conjunction with [Activity Heartbeats](/encyclopedia/detecting-activity-failures#activity-heartbeat). diff --git a/docs/develop/ruby/activities/asynchronous-activity.mdx b/docs/develop/ruby/activities/asynchronous-activity.mdx index d19ec958da..546b1981ff 100644 --- a/docs/develop/ruby/activities/asynchronous-activity.mdx +++ b/docs/develop/ruby/activities/asynchronous-activity.mdx @@ -1,7 +1,7 @@ --- id: asynchronous-activity -title: Asynchronous Activity Completion - Ruby SDK -sidebar_label: Asynchronous Activity Completion +title: Asynchronous Activity completion - Ruby SDK +sidebar_label: Asynchronous Activity completion description: Asynchronously complete an Activity in Temporal using the Ruby SDK. Follow simple steps to allow an Activity Function to return without the Activity Execution completing. toc_max_heading_level: 4 tags: diff --git a/docs/develop/ruby/activities/basics.mdx b/docs/develop/ruby/activities/basics.mdx index aa19f1a1a5..436cf99eaa 100644 --- a/docs/develop/ruby/activities/basics.mdx +++ b/docs/develop/ruby/activities/basics.mdx @@ -2,7 +2,7 @@ id: basics title: Activity basics - Ruby SDK sidebar_label: Activity basics -description: Define an Activity with the Temporal Ruby SDK, pass a single parameter object, and choose the thread pool or fiber executor that runs it. +description: This section explains Activity basics with the Ruby SDK toc_max_heading_level: 4 tags: - Activities diff --git a/docs/develop/ruby/activities/benign-exceptions.mdx b/docs/develop/ruby/activities/benign-exceptions.mdx index 3f94187245..6d57ad3a58 100644 --- a/docs/develop/ruby/activities/benign-exceptions.mdx +++ b/docs/develop/ruby/activities/benign-exceptions.mdx @@ -2,7 +2,7 @@ id: benign-exceptions title: Benign exceptions - Ruby SDK sidebar_label: Benign exceptions -description: Mark expected or non-severe Activity errors as benign to reduce noise in logs, metrics, and OpenTelemetry traces. +description: Mark expected or non-severe Activity errors as benign in Ruby to reduce noise in logs, metrics, and OpenTelemetry traces. toc_max_heading_level: 2 tags: - Activities diff --git a/docs/develop/ruby/activities/dynamic-activity.mdx b/docs/develop/ruby/activities/dynamic-activity.mdx index 882f870923..b73eea333c 100644 --- a/docs/develop/ruby/activities/dynamic-activity.mdx +++ b/docs/develop/ruby/activities/dynamic-activity.mdx @@ -1,8 +1,8 @@ --- id: dynamic-activity -title: Dynamic Activity - Ruby SDK -sidebar_label: Dynamic Activity -description: Register a Dynamic Activity with the Temporal Ruby SDK to handle Activity Types that no other registered Activity implementation matches. +title: Dynamic Activities - Ruby SDK +sidebar_label: Dynamic Activities +description: This section explains Dynamic Activities with the Ruby SDK toc_max_heading_level: 4 tags: - Activities diff --git a/docs/develop/ruby/activities/execution.mdx b/docs/develop/ruby/activities/execution.mdx index ad0df39297..5b45db28da 100644 --- a/docs/develop/ruby/activities/execution.mdx +++ b/docs/develop/ruby/activities/execution.mdx @@ -1,7 +1,7 @@ --- id: execution title: Activity execution - Ruby SDK -description: Spawn an Activity Execution from a Workflow with the Temporal Ruby SDK, set the required Activity Timeouts, and get the Activity's result. +description: Shows how to perform Activity execution with the Ruby SDK sidebar_label: Activity execution slug: /develop/ruby/activities/execution toc_max_heading_level: 3 diff --git a/docs/develop/ruby/activities/index.mdx b/docs/develop/ruby/activities/index.mdx index 19b70fb3fe..076fec5e09 100644 --- a/docs/develop/ruby/activities/index.mdx +++ b/docs/develop/ruby/activities/index.mdx @@ -2,7 +2,7 @@ id: index title: Activities - Ruby SDK sidebar_label: Activities -description: Define Activities, spawn Activity Executions, set Timeouts and Retry Policies, run Standalone Activities, and mark benign errors in Ruby. +description: This section explains how to implement Activities with the Ruby SDK toc_max_heading_level: 4 tags: - Activities @@ -23,8 +23,8 @@ import * as Components from '@site/src/components'; - [Activity basics](/develop/ruby/activities/basics) - [Activity execution](/develop/ruby/activities/execution) - [Standalone Activities Quickstart](/develop/ruby/activities/standalone-activities-quickstart) -- [Standalone Activities](/develop/ruby/activities/standalone-activities) +- [Standalone Activities Feature Guide](/develop/ruby/activities/standalone-activities) - [Timeouts](/develop/ruby/activities/timeouts) -- [Asynchronous Activity Completion](/develop/ruby/activities/asynchronous-activity) +- [Asynchronous Activity completion](/develop/ruby/activities/asynchronous-activity) - [Dynamic Activity](/develop/ruby/activities/dynamic-activity) - [Benign exceptions](/develop/ruby/activities/benign-exceptions) diff --git a/docs/develop/ruby/activities/standalone-activities-quickstart.mdx b/docs/develop/ruby/activities/standalone-activities-quickstart.mdx index 70b74d8b7f..29764521d1 100644 --- a/docs/develop/ruby/activities/standalone-activities-quickstart.mdx +++ b/docs/develop/ruby/activities/standalone-activities-quickstart.mdx @@ -1,6 +1,6 @@ --- id: standalone-activities-quickstart -title: Standalone Activities Quickstart - Ruby SDK +title: Standalone Activities Ruby Quickstart sidebar_label: Quickstart description: Execute a Standalone Activity with the Temporal Ruby SDK without writing a Workflow. tags: diff --git a/docs/develop/ruby/activities/standalone-activities.mdx b/docs/develop/ruby/activities/standalone-activities.mdx index 9c12a96941..8ff5fe3b5e 100644 --- a/docs/develop/ruby/activities/standalone-activities.mdx +++ b/docs/develop/ruby/activities/standalone-activities.mdx @@ -1,6 +1,6 @@ --- id: standalone-activities -title: Standalone Activities - Ruby SDK +title: Standalone Activities Feature Guide sidebar_label: Feature Guide toc_max_heading_level: 4 tags: diff --git a/docs/develop/ruby/activities/timeouts.mdx b/docs/develop/ruby/activities/timeouts.mdx index 2015c7731c..866d9a5c04 100644 --- a/docs/develop/ruby/activities/timeouts.mdx +++ b/docs/develop/ruby/activities/timeouts.mdx @@ -2,7 +2,7 @@ id: timeouts title: Activity Timeouts - Ruby SDK sidebar_label: Timeouts -description: Set Activity Timeouts and a Retry Policy with the Temporal Ruby SDK, override the next retry delay, and Heartbeat long-running Activities. +description: Set the Schedule-To-Close, Start-To-Close, and Heartbeat Timeouts on a Ruby Activity, tune its Retry Policy, and override the next retry delay. toc_max_heading_level: 4 tags: - Activities diff --git a/docs/develop/rust/activities/basics.mdx b/docs/develop/rust/activities/basics.mdx index 03430a2988..0431c67621 100644 --- a/docs/develop/rust/activities/basics.mdx +++ b/docs/develop/rust/activities/basics.mdx @@ -2,7 +2,7 @@ id: basics title: Activity basics - Rust SDK sidebar_label: Activity basics -description: Define an Activity with the Temporal Rust SDK, pass a single parameter object within Payload size limits, and customize the Activity Type name. +description: This section explains Activity basics with the Rust SDK toc_max_heading_level: 4 tags: - Activities diff --git a/docs/develop/rust/activities/execution.mdx b/docs/develop/rust/activities/execution.mdx index 886243bf6a..cadd6a1742 100644 --- a/docs/develop/rust/activities/execution.mdx +++ b/docs/develop/rust/activities/execution.mdx @@ -1,7 +1,7 @@ --- id: execution title: Activity execution - Rust SDK -description: Spawn an Activity Execution from a Workflow with the Temporal Rust SDK, set the required Activity Timeouts, and get the Activity's result. +description: Shows how to perform Activity execution with the Rust SDK sidebar_label: Activity execution slug: /develop/rust/activities/execution toc_max_heading_level: 3 diff --git a/docs/develop/rust/activities/index.mdx b/docs/develop/rust/activities/index.mdx index 0348ad8337..6707ff491c 100644 --- a/docs/develop/rust/activities/index.mdx +++ b/docs/develop/rust/activities/index.mdx @@ -2,7 +2,8 @@ id: index title: Activities - Rust SDK sidebar_label: Activities -description: Define Activities, spawn Activity Executions from a Workflow, and set Activity Timeouts, Retry Policies, and Heartbeats with the Temporal Rust SDK. +description: + This section explains how to implement Activities with the Rust SDK toc_max_heading_level: 4 tags: - Activities diff --git a/docs/develop/rust/activities/timeouts.mdx b/docs/develop/rust/activities/timeouts.mdx index 21d33f8b1f..60f8a4a681 100644 --- a/docs/develop/rust/activities/timeouts.mdx +++ b/docs/develop/rust/activities/timeouts.mdx @@ -2,7 +2,7 @@ id: timeouts title: Activity Timeouts - Rust SDK sidebar_label: Timeouts -description: Set Activity Timeouts and a Retry Policy with the Temporal Rust SDK, override the next retry delay, and Heartbeat long-running Activities. +description: Set the Schedule-To-Close, Start-To-Close, and Heartbeat Timeouts on a Rust Activity, tune its Retry Policy, and override the next retry delay. toc_max_heading_level: 4 tags: - Activities diff --git a/docs/develop/typescript/activities/asynchronous-activity.mdx b/docs/develop/typescript/activities/asynchronous-activity.mdx index 315b39b9bb..4be849339c 100644 --- a/docs/develop/typescript/activities/asynchronous-activity.mdx +++ b/docs/develop/typescript/activities/asynchronous-activity.mdx @@ -1,7 +1,7 @@ --- id: asynchronous-activity -title: Asynchronous Activity Completion - TypeScript SDK -sidebar_label: Asynchronous Activity Completion +title: Asynchronous Activity - TypeScript SDK +sidebar_label: Asynchronous Activity slug: /develop/typescript/activities/asynchronous-activity toc_max_heading_level: 2 tags: diff --git a/docs/develop/typescript/activities/basics.mdx b/docs/develop/typescript/activities/basics.mdx index f1ab52ad35..b514659a34 100644 --- a/docs/develop/typescript/activities/basics.mdx +++ b/docs/develop/typescript/activities/basics.mdx @@ -1,7 +1,7 @@ --- id: basics title: Activity basics - TypeScript SDK -description: Define an Activity with the Temporal TypeScript SDK, choose parameters and return values, and share dependencies across Activity functions. +description: Shows how to create an Activity with the TypeScript SDK sidebar_label: Activity basics slug: /develop/typescript/activities/basics toc_max_heading_level: 3 diff --git a/docs/develop/typescript/activities/benign-exceptions.mdx b/docs/develop/typescript/activities/benign-exceptions.mdx index 9fad3eac7a..74eae367e2 100644 --- a/docs/develop/typescript/activities/benign-exceptions.mdx +++ b/docs/develop/typescript/activities/benign-exceptions.mdx @@ -2,7 +2,7 @@ id: benign-exceptions title: Benign exceptions - TypeScript SDK sidebar_label: Benign exceptions -description: Mark expected or non-severe Activity errors as benign to reduce noise in logs, metrics, and OpenTelemetry traces. +description: Mark expected or non-severe Activity errors as benign in TypeScript to reduce noise in logs, metrics, and OpenTelemetry traces. toc_max_heading_level: 2 tags: - Activities diff --git a/docs/develop/typescript/activities/execution.mdx b/docs/develop/typescript/activities/execution.mdx index 6cadbf2764..d1a9ab02e1 100644 --- a/docs/develop/typescript/activities/execution.mdx +++ b/docs/develop/typescript/activities/execution.mdx @@ -1,7 +1,7 @@ --- id: execution title: Activity execution - TypeScript SDK -description: Spawn an Activity Execution from a Workflow with the Temporal TypeScript SDK, set the required Activity Timeouts, and get the Activity's result. +description: Shows how to perform Activity execution with the TypeScript SDK sidebar_label: Activity execution slug: /develop/typescript/activities/execution toc_max_heading_level: 3 @@ -50,10 +50,14 @@ also retry an Activity if it fails or times out. For this reason, you should wri [idempotent](/encyclopedia/activities/activity-definition.mdx#idempotency): calling them multiple times with the same input should have the same effect as calling them once. -:::tip Every Activity call you make is recorded in the Workflow’s execution history, including the parameters you pass +:::tip + +Every Activity call you make is recorded in the Workflow’s execution history, including the parameters you pass in and the value that comes back. This history is what allows Temporal to recover a Workflow after a failure. Because the entire history must be stored and replayed, avoid passing large objects as Activity inputs or return values. Keeping -payloads small will help your Workflows replay and recover efficiently. ::: +payloads small will help your Workflows replay and recover efficiently. + +::: ## Set the required Activity Timeouts {/* #required-timeout */} diff --git a/docs/develop/typescript/activities/index.mdx b/docs/develop/typescript/activities/index.mdx index c847b92b6c..052bd97061 100644 --- a/docs/develop/typescript/activities/index.mdx +++ b/docs/develop/typescript/activities/index.mdx @@ -2,7 +2,7 @@ id: index title: Activities - TypeScript SDK sidebar_label: Activities -description: Define Activities, spawn Activity Executions, set Timeouts and Retry Policies, run Standalone Activities, and mark benign errors in TypeScript. +description: This section explains how to implement Activities with the TypeScript SDK toc_max_heading_level: 4 tags: - Activities @@ -23,7 +23,7 @@ import * as Components from '@site/src/components'; - [Activity basics](/develop/typescript/activities/basics) - [Activity execution](/develop/typescript/activities/execution) - [Standalone Activities Quickstart](/develop/typescript/activities/standalone-activities-quickstart) -- [Standalone Activities](/develop/typescript/activities/standalone-activities) +- [Standalone Activities Feature Guide](/develop/typescript/activities/standalone-activities) - [Timeouts](/develop/typescript/activities/timeouts) -- [Asynchronous Activity Completion](/develop/typescript/activities/asynchronous-activity) +- [Asynchronous Activity](/develop/typescript/activities/asynchronous-activity) - [Benign exceptions](/develop/typescript/activities/benign-exceptions) diff --git a/docs/develop/typescript/activities/standalone-activities-quickstart.mdx b/docs/develop/typescript/activities/standalone-activities-quickstart.mdx index 13da901e62..0f26b866dc 100644 --- a/docs/develop/typescript/activities/standalone-activities-quickstart.mdx +++ b/docs/develop/typescript/activities/standalone-activities-quickstart.mdx @@ -1,6 +1,6 @@ --- id: standalone-activities-quickstart -title: Standalone Activities Quickstart - TypeScript SDK +title: Standalone Activities TypeScript Quickstart sidebar_label: Quickstart description: Execute a Standalone Activity with the Temporal TypeScript SDK without writing a Workflow. tags: diff --git a/docs/develop/typescript/activities/standalone-activities.mdx b/docs/develop/typescript/activities/standalone-activities.mdx index 4a1962a94a..330be0cc20 100644 --- a/docs/develop/typescript/activities/standalone-activities.mdx +++ b/docs/develop/typescript/activities/standalone-activities.mdx @@ -1,6 +1,6 @@ --- id: standalone-activities -title: Standalone Activities - TypeScript SDK +title: Standalone Activities Feature Guide sidebar_label: Feature Guide toc_max_heading_level: 4 tags: diff --git a/docs/develop/typescript/activities/timeouts.mdx b/docs/develop/typescript/activities/timeouts.mdx index 0311cef177..b08228223e 100644 --- a/docs/develop/typescript/activities/timeouts.mdx +++ b/docs/develop/typescript/activities/timeouts.mdx @@ -2,7 +2,7 @@ id: timeouts title: Activity Timeouts - TypeScript SDK sidebar_label: Timeouts -description: Set Activity Timeouts and a Retry Policy with the Temporal TypeScript SDK, override the next retry delay, and Heartbeat long-running Activities. +description: Set the Schedule-To-Close, Start-To-Close, and Heartbeat Timeouts on a TypeScript Activity, tune its Retry Policy, and override the next retry delay. toc_max_heading_level: 4 tags: - Activities From dc43ed1a409247dd42fb96fdf8171c2679b7beba Mon Sep 17 00:00:00 2001 From: Jwahir Sundai Date: Tue, 15 Sep 2026 14:42:45 -0500 Subject: [PATCH 3/7] Correct capitalization in section heading --- docs/develop/dotnet/activities/timeouts.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/develop/dotnet/activities/timeouts.mdx b/docs/develop/dotnet/activities/timeouts.mdx index df48f9514c..f77c8fa425 100644 --- a/docs/develop/dotnet/activities/timeouts.mdx +++ b/docs/develop/dotnet/activities/timeouts.mdx @@ -57,7 +57,7 @@ return await Workflow.ExecuteActivityAsync( }); ``` -### Override the retry interval with `nextRetryDelay` {/* #next-retry-delay */} +### Override the Retry interval with `nextRetryDelay` {/* #next-retry-delay */} When you throw an [Application Failure](/references/failures#application-failure) and assign the `nextRetryDelay` field, its value replaces and overrides the Retry interval defined in the active Retry Policy. From 805eb25abd78f591f7f54eb6287b1d5f3d80fc5b Mon Sep 17 00:00:00 2001 From: Jwahir Sundai Date: Tue, 15 Sep 2026 14:43:20 -0500 Subject: [PATCH 4/7] Update execution.mdx --- docs/develop/java/activities/execution.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/develop/java/activities/execution.mdx b/docs/develop/java/activities/execution.mdx index 1f916aea11..4f6e047640 100644 --- a/docs/develop/java/activities/execution.mdx +++ b/docs/develop/java/activities/execution.mdx @@ -2,7 +2,7 @@ id: execution title: Activity execution - Java SDK description: Invoke Activities synchronously or asynchronously from a Java Workflow, set ActivityOptions and Timeouts, and read the ActivityExecutionContext. -sidebar_label: Activity execution +sidebar_label: Activity Execution slug: /develop/java/activities/execution toc_max_heading_level: 3 tags: From 994fcf41cd695c2e212112599eb766088f166f10 Mon Sep 17 00:00:00 2001 From: Jwahir Sundai Date: Tue, 15 Sep 2026 14:48:55 -0500 Subject: [PATCH 5/7] Correct capitalization of 'Execution' in activities list --- docs/develop/php/activities/index.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/develop/php/activities/index.mdx b/docs/develop/php/activities/index.mdx index 7044c23dbe..e1df4e5c09 100644 --- a/docs/develop/php/activities/index.mdx +++ b/docs/develop/php/activities/index.mdx @@ -21,6 +21,6 @@ import * as Components from '@site/src/components'; ## Activities - [Activity basics](/develop/php/activities/basics) -- [Activity execution](/develop/php/activities/execution) +- [Activity Execution](/develop/php/activities/execution) - [Timeouts](/develop/php/activities/timeouts) - [Asynchronous Activity Completion](/develop/php/activities/asynchronous-activity) From 2ea2ea479b3a238aa18a1009cc6578a3c4d9bdc9 Mon Sep 17 00:00:00 2001 From: Jwahir Sundai Date: Tue, 15 Sep 2026 15:17:27 -0500 Subject: [PATCH 6/7] additional changes --- docs/develop/dotnet/activities/basics.mdx | 4 ++-- .../dotnet/activities/dynamic-activity.mdx | 2 +- docs/develop/dotnet/activities/execution.mdx | 12 ++++++------ docs/develop/dotnet/activities/index.mdx | 4 ++-- docs/develop/dotnet/index.mdx | 4 ++-- docs/develop/go/activities/basics.mdx | 4 ++-- .../develop/go/activities/dynamic-activity.mdx | 2 +- docs/develop/go/activities/execution.mdx | 4 ++-- docs/develop/go/activities/index.mdx | 4 ++-- docs/develop/go/index.mdx | 4 ++-- docs/develop/java/activities/basics.mdx | 4 ++-- docs/develop/java/activities/execution.mdx | 18 +++++++++--------- docs/develop/java/activities/index.mdx | 4 ++-- docs/develop/java/activities/timeouts.mdx | 4 ++-- docs/develop/java/index.mdx | 4 ++-- .../php/activities/asynchronous-activity.mdx | 2 +- docs/develop/php/activities/basics.mdx | 6 +++--- docs/develop/php/activities/execution.mdx | 6 +++--- docs/develop/php/activities/index.mdx | 4 ++-- docs/develop/php/activities/timeouts.mdx | 2 +- docs/develop/python/activities/basics.mdx | 4 ++-- docs/develop/python/activities/execution.mdx | 10 +++++----- docs/develop/python/activities/index.mdx | 4 ++-- docs/develop/python/index.mdx | 4 ++-- docs/develop/ruby/activities/basics.mdx | 4 ++-- .../ruby/activities/dynamic-activity.mdx | 2 +- docs/develop/ruby/activities/execution.mdx | 14 +++++++------- docs/develop/ruby/activities/index.mdx | 4 ++-- docs/develop/ruby/index.mdx | 4 ++-- docs/develop/rust/activities/basics.mdx | 2 +- docs/develop/rust/activities/execution.mdx | 6 +++--- docs/develop/rust/activities/index.mdx | 5 ++--- docs/develop/rust/index.mdx | 4 ++-- docs/develop/typescript/activities/basics.mdx | 6 +++--- .../typescript/activities/execution.mdx | 6 +++--- docs/develop/typescript/activities/index.mdx | 4 ++-- .../develop/typescript/activities/timeouts.mdx | 6 +++--- docs/develop/typescript/index.mdx | 4 ++-- 38 files changed, 95 insertions(+), 96 deletions(-) diff --git a/docs/develop/dotnet/activities/basics.mdx b/docs/develop/dotnet/activities/basics.mdx index 05f2d0a7c2..d498302111 100644 --- a/docs/develop/dotnet/activities/basics.mdx +++ b/docs/develop/dotnet/activities/basics.mdx @@ -2,7 +2,7 @@ id: basics title: Activity basics - .NET SDK sidebar_label: Activity basics -description: This section explains Activity basics with the .NET SDK +description: Define an Activity as a .NET method with the Activity attribute, give it a custom name, and keep argument Payloads inside the 2 MB and 4 MB gRPC limits. toc_max_heading_level: 4 tags: - Activities @@ -14,7 +14,7 @@ tags: One of the primary things that Workflows do is orchestrate the execution of Activities. An Activity is a normal method execution that's intended to execute a single, well-defined action (either short or long-running), such as querying a database, calling a third-party API, or transcoding a media file. -An Activity can interact with world outside the Temporal Platform or use a Temporal Client to interact with a Temporal Service. +An Activity can interact with the world outside the Temporal Platform or use a Temporal Client to interact with a Temporal Service. For the Workflow to be able to execute the Activity, we must define the [Activity Definition](/activity-definition). Standalone Activities are Activities that run independently, without being orchestrated by a Workflow. Instead of starting an Activity from within a Workflow Definition, you start a Standalone Activity directly from a Temporal Client. diff --git a/docs/develop/dotnet/activities/dynamic-activity.mdx b/docs/develop/dotnet/activities/dynamic-activity.mdx index 80ed957b33..133748b7c5 100644 --- a/docs/develop/dotnet/activities/dynamic-activity.mdx +++ b/docs/develop/dotnet/activities/dynamic-activity.mdx @@ -2,7 +2,7 @@ id: dynamic-activity title: Dynamic Activity - .NET SDK sidebar_label: Dynamic Activity -description: This section explains Dynamic Activities with the .NET SDK +description: Register one Dynamic Activity per Worker with Activity(Dynamic = true) to handle Activity Types that match no other registered Activity. toc_max_heading_level: 4 tags: - Activities diff --git a/docs/develop/dotnet/activities/execution.mdx b/docs/develop/dotnet/activities/execution.mdx index bc7be9cf5b..8919acddeb 100644 --- a/docs/develop/dotnet/activities/execution.mdx +++ b/docs/develop/dotnet/activities/execution.mdx @@ -1,8 +1,8 @@ --- id: execution -title: Activity execution - .NET SDK -description: Shows how to perform Activity execution with the .NET SDK -sidebar_label: Activity execution +title: Activity Execution - .NET SDK +description: Call an Activity from a .NET Workflow with ExecuteActivityAsync, set the required Schedule-To-Close or Start-To-Close Timeout, and await the result. +sidebar_label: Activity Execution slug: /develop/dotnet/activities/execution toc_max_heading_level: 3 tags: @@ -11,7 +11,7 @@ tags: - Temporal SDKs --- -## Start Activity Execution {/* #activity-execution */} +## Start an Activity Execution {/* #activity-execution */} Calls to spawn [Activity Executions](/activity-execution) are written within a [Workflow Definition](/workflow-definition). The call to spawn an Activity Execution generates the [ScheduleActivityTask](/references/commands#scheduleactivitytask) Command. @@ -21,7 +21,7 @@ A single instance of the Activities implementation is shared across multiple sim Activity implementation code should be _idempotent_. The values passed to Activities through invocation parameters or returned through a result value are recorded in the Execution history. -The entire Execution history is transferred from the Temporal service to Workflow Workers when a Workflow state needs to recover. +The entire Execution history is transferred from the Temporal Service to Workflow Workers when a Workflow state needs to recover. A large Execution history can thus adversely impact the performance of your Workflow. Therefore, be mindful of the amount of data you transfer through Activity invocation parameters or Return Values. @@ -49,6 +49,6 @@ Activity Execution semantics rely on several parameters. The only required value that needs to be set is either a [Schedule-To-Close Timeout](/encyclopedia/detecting-activity-failures#schedule-to-close-timeout) or a [Start-To-Close Timeout](/encyclopedia/detecting-activity-failures#start-to-close-timeout). These values are set in the Activity Options. -### Get Activity Execution results {/* #get-activity-results */} +### Get the results of an Activity Execution {/* #get-activity-results */} The Activity result is returned in the Task from the `ExecuteActivityAsync` call. diff --git a/docs/develop/dotnet/activities/index.mdx b/docs/develop/dotnet/activities/index.mdx index da386b5744..36597a0041 100644 --- a/docs/develop/dotnet/activities/index.mdx +++ b/docs/develop/dotnet/activities/index.mdx @@ -2,7 +2,7 @@ id: index title: Activities - .NET SDK sidebar_label: Activities -description: This section explains how to implement Activities with the .NET SDK +description: Activity Definitions, Activity Execution, Timeouts, Standalone Activities, Dynamic Activities, and benign exceptions in the Temporal .NET SDK. toc_max_heading_level: 4 tags: - Activities @@ -21,7 +21,7 @@ import * as Components from '@site/src/components'; ## Activities - [Activity basics](/develop/dotnet/activities/basics) -- [Activity execution](/develop/dotnet/activities/execution) +- [Activity Execution](/develop/dotnet/activities/execution) - [Standalone Activities Quickstart](/develop/dotnet/activities/standalone-activities-quickstart) - [Standalone Activities Feature Guide](/develop/dotnet/activities/standalone-activities) - [Timeouts](/develop/dotnet/activities/timeouts) diff --git a/docs/develop/dotnet/index.mdx b/docs/develop/dotnet/index.mdx index a9c62b4d61..6acafe7f29 100644 --- a/docs/develop/dotnet/index.mdx +++ b/docs/develop/dotnet/index.mdx @@ -29,7 +29,7 @@ Once your local Temporal Service is set up, continue building with the following - [Workflow basics](/develop/dotnet/workflows/basics) - [Activity basics](/develop/dotnet/activities/basics) -- [Start an Activity execution](/develop/dotnet/activities/execution) +- [Start an Activity Execution](/develop/dotnet/activities/execution) - [Run Worker processes](/develop/dotnet/workers/run-worker-process) From there, you can dive deeper into any of the Temporal primitives to start building Workflows that fit your use cases. @@ -50,7 +50,7 @@ From there, you can dive deeper into any of the Temporal primitives to start bui ## [Activities](/develop/dotnet/activities) - [Activity basics](/develop/dotnet/activities/basics) -- [Activity execution](/develop/dotnet/activities/execution) +- [Activity Execution](/develop/dotnet/activities/execution) - [Standalone Activities](/develop/dotnet/activities/standalone-activities-quickstart) - [Timeouts](/develop/dotnet/activities/timeouts) - [Asynchronous Activity completion](/develop/dotnet/activities/asynchronous-activity) diff --git a/docs/develop/go/activities/basics.mdx b/docs/develop/go/activities/basics.mdx index 10dbc8bbcf..0d0b402951 100644 --- a/docs/develop/go/activities/basics.mdx +++ b/docs/develop/go/activities/basics.mdx @@ -2,7 +2,7 @@ id: basics title: Activity basics - Go SDK sidebar_label: Activity basics -description: This section explains Activity basics with the Go SDK +description: An Activity Definition in Go is an exportable function or struct method. Set its parameters, return values, and a custom Activity Type name. toc_max_heading_level: 4 tags: - Activities @@ -72,7 +72,7 @@ func (a *YourActivityObject) YourActivityDefinition(ctx context.Context, param Y } ``` -### Develop Activity parameters {/* #activity-parameters */} +### Define Activity parameters {/* #activity-parameters */} There is no explicit limit to the total number of parameters that an [Activity Definition](/activity-definition) may support. However, there is a limit to the total size of the data that ends up encoded into a gRPC message Payload. diff --git a/docs/develop/go/activities/dynamic-activity.mdx b/docs/develop/go/activities/dynamic-activity.mdx index 6ab7929186..f2b2ffdecb 100644 --- a/docs/develop/go/activities/dynamic-activity.mdx +++ b/docs/develop/go/activities/dynamic-activity.mdx @@ -2,7 +2,7 @@ id: dynamic-activity title: Dynamic Activity - Go SDK sidebar_label: Dynamic Activity -description: This section explains Dynamic Activities with the Go SDK +description: Register one Dynamic Activity per Worker with RegisterDynamicActivity to handle Activity Types that match no other registered Activity. toc_max_heading_level: 4 tags: - Activities diff --git a/docs/develop/go/activities/execution.mdx b/docs/develop/go/activities/execution.mdx index 8daf5c401a..d739a80449 100644 --- a/docs/develop/go/activities/execution.mdx +++ b/docs/develop/go/activities/execution.mdx @@ -1,7 +1,7 @@ --- id: execution -title: Activity execution - Go SDK -description: Shows how to perform Activity execution with the Go SDK +title: Activity Execution - Go SDK +description: Call an Activity from a Go Workflow with workflow.ExecuteActivity, set the required Timeout, and look up every ActivityOptions field in one table. sidebar_label: Activity Execution slug: /develop/go/activities/execution toc_max_heading_level: 3 diff --git a/docs/develop/go/activities/index.mdx b/docs/develop/go/activities/index.mdx index 5370de47c0..ff5059cf06 100644 --- a/docs/develop/go/activities/index.mdx +++ b/docs/develop/go/activities/index.mdx @@ -2,7 +2,7 @@ id: index title: Activities - Go SDK sidebar_label: Activities -description: This section explains how to implement Activities with the Go SDK +description: Activity Definitions, Activity Execution, Timeouts, Standalone Activities, Dynamic Activities, and benign exceptions in the Temporal Go SDK. toc_max_heading_level: 4 tags: - Activities @@ -21,7 +21,7 @@ import * as Components from '@site/src/components'; ## Activities - [Activity basics](/develop/go/activities/basics) -- [Activity execution](/develop/go/activities/execution) +- [Activity Execution](/develop/go/activities/execution) - [Standalone Activities Quickstart](/develop/go/activities/standalone-activities-quickstart) - [Standalone Activities Feature Guide](/develop/go/activities/standalone-activities) - [Timeouts](/develop/go/activities/timeouts) diff --git a/docs/develop/go/index.mdx b/docs/develop/go/index.mdx index dd73338d4d..ac85e9018c 100644 --- a/docs/develop/go/index.mdx +++ b/docs/develop/go/index.mdx @@ -29,7 +29,7 @@ Once your local Temporal Service is set up, continue building with the following - [Workflow basics](/develop/go/workflows/basics) - [Activity basics](/develop/go/activities/basics) -- [Start an Activity execution](/develop/go/activities/execution) +- [Start an Activity Execution](/develop/go/activities/execution) - [Run Worker processes](/develop/go/workers/run-worker-process) From there, you can dive deeper into any of the Temporal primitives to start building Workflows that fit your use cases. @@ -53,7 +53,7 @@ From there, you can dive deeper into any of the Temporal primitives to start bui ## [Activities](/develop/go/activities) - [Activity basics](/develop/go/activities/basics) -- [Activity execution](/develop/go/activities/execution) +- [Activity Execution](/develop/go/activities/execution) - [Standalone Activities](/develop/go/activities/standalone-activities-quickstart) - [Timeouts](/develop/go/activities/timeouts) - [Asynchronous Activity completion](/develop/go/activities/asynchronous-activity) diff --git a/docs/develop/java/activities/basics.mdx b/docs/develop/java/activities/basics.mdx index 4a90db5af2..6282c4d8f1 100644 --- a/docs/develop/java/activities/basics.mdx +++ b/docs/develop/java/activities/basics.mdx @@ -2,7 +2,7 @@ id: basics title: Activity basics - Java SDK sidebar_label: Activity basics -description: This section explains Activity basics with the Java SDK +description: Implement an Activity behind an annotated Java interface, define its parameters and return values, and control Activity Type names with prefixes. toc_max_heading_level: 4 tags: - Activities @@ -14,7 +14,7 @@ tags: One of the primary things that Workflows do is orchestrate the execution of Activities. An Activity is a normal function or method execution that's intended to execute a single, well-defined action (either short or long-running), such as querying a database, calling a third-party API, or transcoding a media file. -An Activity can interact with world outside the Temporal Platform or use a Temporal Client to interact with a Temporal Service. +An Activity can interact with the world outside the Temporal Platform or use a Temporal Client to interact with a Temporal Service. For the Workflow to be able to execute the Activity, we must define the [Activity Definition](/activity-definition). [Standalone Activities](/standalone-activity) are Activities that run independently, without being orchestrated by a Workflow. Instead of starting an Activity from within a Workflow Definition, you start a Standalone Activity directly from a Temporal Client. diff --git a/docs/develop/java/activities/execution.mdx b/docs/develop/java/activities/execution.mdx index fafbc700fd..36c556c0bd 100644 --- a/docs/develop/java/activities/execution.mdx +++ b/docs/develop/java/activities/execution.mdx @@ -1,7 +1,7 @@ --- id: execution -title: Activity execution - Java SDK -description: Shows how to perform Activity execution with the Java SDK +title: Activity Execution - Java SDK +description: Invoke Activities synchronously or asynchronously from a Java Workflow, set ActivityOptions and Timeouts, and read the ActivityExecutionContext. sidebar_label: Activity Execution slug: /develop/java/activities/execution toc_max_heading_level: 3 @@ -21,7 +21,7 @@ A single instance of the Activities implementation is shared across multiple sim Activity implementation code should be _idempotent_. The values passed to Activities through invocation parameters or returned through a result value are recorded in the Execution history. -The entire Execution history is transferred from the Temporal service to Workflow Workers when a Workflow state needs to recover. +The entire Execution history is transferred from the Temporal Service to Workflow Workers when a Workflow state needs to recover. A large Execution history can thus adversely impact the performance of your Workflow. Therefore, be mindful of the amount of data you transfer through Activity invocation parameters or Return Values. @@ -42,11 +42,11 @@ Activities should only be instantiated using stubs from within a Workflow. An `ActivityStub` returns a client-side stub that implements an Activity interface. You can invoke Activities using `Workflow.newActivityStub`(type-safe) or `Workflow.newUntypedActivityStub` (untyped). -Calling a method on the Activity interface schedules the Activity invocation with the Temporal service, and generates an [`ActivityTaskScheduled` Event](/references/events#activitytaskscheduled). +Calling a method on the Activity interface schedules the Activity invocation with the Temporal Service, and generates an [`ActivityTaskScheduled` Event](/references/events#activitytaskscheduled). Activities can be invoked synchronously or asynchronously. -### Invoke Activities synchronously +### Invoke Activities synchronously {/* #invoking-activities-synchronously */} In the following example, we use the type-safe `Workflow.newActivityStub` within the "FileProcessingWorkflow" Workflow implementation to create a client-side stub of the `FileProcessingActivities` class. We also define `ActivityOptions` and set `setStartToCloseTimeout` option to one hour. @@ -118,7 +118,7 @@ This is useful when the Activity type is not known at compile time, or to invoke activity.execute("ComposeGreeting", String.class, "Hello World", "Spanish"); ``` -### Invoke Activities asynchronously +### Invoke Activities asynchronously {/* #invoking-activities-asynchronously */} Sometimes Workflows need to perform certain operations in parallel. The Temporal Java SDK provides the `Async` class which includes static methods used to invoke any Activity asynchronously. @@ -179,7 +179,7 @@ The following example shows how to call two Activity methods, "download" and "up } ``` -### ActivityExecutionContext +### ActivityExecutionContext {/* #activity-execution-context */} `ActivityExecutionContext` is a context object passed to each Activity implementation by default. You can access it in your Activity implementations via `Activity.getExecutionContext()`. @@ -213,7 +213,7 @@ public class FileProcessingActivitiesImpl implements FileProcessingActivities { For details on getting the results of an Activity Execution, see [Activity Execution Result](#activity-execution-result). -## Set required Activity Timeouts {/* #required-timeout */} +## Set the required Activity Timeouts {/* #required-timeout */} Activity Execution semantics rely on several parameters. The only required value that needs to be set is either a [Schedule-To-Close Timeout](/encyclopedia/detecting-activity-failures#schedule-to-close-timeout) or a [Start-To-Close Timeout](/encyclopedia/detecting-activity-failures#start-to-close-timeout). @@ -528,7 +528,7 @@ To set a Retry Policy, known as the [Retry Options](/encyclopedia/retry-policies .build(); ``` -## Get the result of an Activity Execution {/* #activity-execution-result */} +## Get the results of an Activity Execution {/* #activity-execution-result */} The call to spawn an [Activity Execution](/activity-execution) generates the [ScheduleActivityTask](/references/commands#scheduleactivitytask) Command and provides the Workflow with an Awaitable. Workflow Executions can either block progress until the result is available through the Awaitable or continue progressing, making use of the result when it becomes available. diff --git a/docs/develop/java/activities/index.mdx b/docs/develop/java/activities/index.mdx index 8e2fb0b478..1ab2854bb2 100644 --- a/docs/develop/java/activities/index.mdx +++ b/docs/develop/java/activities/index.mdx @@ -2,7 +2,7 @@ id: index title: Activities - Java SDK sidebar_label: Activities -description: This section explains how to implement Activities with the Java SDK +description: Activity Definitions, Activity Execution, Timeouts, Standalone Activities, and benign exceptions in the Temporal Java SDK. toc_max_heading_level: 4 tags: - Activities @@ -21,7 +21,7 @@ import * as Components from '@site/src/components'; ## Activities - [Activity basics](/develop/java/activities/basics) -- [Activity execution](/develop/java/activities/execution) +- [Activity Execution](/develop/java/activities/execution) - [Standalone Activities Quickstart](/develop/java/activities/standalone-activities-quickstart) - [Standalone Activities Feature Guide](/develop/java/activities/standalone-activities) - [Timeouts](/develop/java/activities/timeouts) diff --git a/docs/develop/java/activities/timeouts.mdx b/docs/develop/java/activities/timeouts.mdx index 49a3c022ff..0a57ace9da 100644 --- a/docs/develop/java/activities/timeouts.mdx +++ b/docs/develop/java/activities/timeouts.mdx @@ -2,7 +2,7 @@ id: timeouts title: Activity Timeouts - Java SDK sidebar_label: Timeouts -description: This section explains how to set Activity Timeouts with the Java SDK +description: Set the Schedule-To-Close, Start-To-Close, and Heartbeat Timeouts on a Java Activity, tune its Retry Policy, and override the next retry delay. toc_max_heading_level: 4 tags: - Activities @@ -116,7 +116,7 @@ To set a Retry Policy, known as the [Retry Options](/encyclopedia/retry-policies .build(); ``` -## Activity next retry delay {/* #activity-next-retry-delay */} +### Activity next retry delay {/* #activity-next-retry-delay */} You may throw an [`ApplicationFailure`](/references/failures#application-failure) with the `NextRetryDelay` field set. This value will replace and override whatever the retry interval would be on the retry policy. diff --git a/docs/develop/java/index.mdx b/docs/develop/java/index.mdx index 70baaf8dce..3d52509c63 100644 --- a/docs/develop/java/index.mdx +++ b/docs/develop/java/index.mdx @@ -27,7 +27,7 @@ Once your local Temporal Service is set up, continue building with the following - [Develop a Workflow](/develop/java/workflows/basics) - [Develop an Activity](/develop/java/activities/basics) -- [Start an Activity execution](/develop/java/activities/execution) +- [Start an Activity Execution](/develop/java/activities/execution) - [Run Worker processes](/develop/java/workers/run-worker-process) From there, you can dive deeper into any of the Temporal primitives to start building Workflows that fit your use cases. @@ -49,7 +49,7 @@ From there, you can dive deeper into any of the Temporal primitives to start bui ## [Activities](/develop/java/activities) - [Activity basics](/develop/java/activities/basics) -- [Activity execution](/develop/java/activities/execution) +- [Activity Execution](/develop/java/activities/execution) - [Standalone Activities](/develop/java/activities/standalone-activities-quickstart) - [Timeouts](/develop/java/activities/timeouts) - [Asynchronous Activity Completion](/develop/java/activities/asynchronous-activity) diff --git a/docs/develop/php/activities/asynchronous-activity.mdx b/docs/develop/php/activities/asynchronous-activity.mdx index 92abb6c588..0a10728b54 100644 --- a/docs/develop/php/activities/asynchronous-activity.mdx +++ b/docs/develop/php/activities/asynchronous-activity.mdx @@ -78,7 +78,7 @@ There are two parts to implementing an asynchronously completed Activity: 1. The Activity provides the information necessary for completion from an external system and notifies the Temporal service that it is waiting for that outside callback. -2. The external service calls the Temporal service to complete the Activity. +2. The external service calls the Temporal Service to complete the Activity. The following example demonstrates the first part: diff --git a/docs/develop/php/activities/basics.mdx b/docs/develop/php/activities/basics.mdx index 7e24526db6..55aef95341 100644 --- a/docs/develop/php/activities/basics.mdx +++ b/docs/develop/php/activities/basics.mdx @@ -2,7 +2,7 @@ id: basics title: Activity basics - PHP SDK sidebar_label: Activity basics -description: This section explains Activity basics with the PHP SDK +description: Implement an Activity behind a PHP interface, define its parameters and return values, and set a custom name for the Activity Type. toc_max_heading_level: 4 tags: - Activities @@ -14,7 +14,7 @@ tags: One of the primary things that Workflows do is orchestrate the execution of Activities. An Activity is a normal function or method execution that's intended to execute a single, well-defined action (either short or long-running), such as querying a database, calling a third-party API, or transcoding a media file. -An Activity can interact with world outside the Temporal Platform or use a Temporal Client to interact with a Temporal Service. +An Activity can interact with the world outside the Temporal Platform or use a Temporal Client to interact with a Temporal Service. For the Workflow to be able to execute the Activity, we must define the [Activity Definition](/activity-definition). Activities are defined as methods of a plain PHP interface annotated with `#[ActivityInterface]`. @@ -37,7 +37,7 @@ interface FileProcessingActivities } ``` -### Develop Activity parameters {/* #activity-parameters */} +### Define Activity parameters {/* #activity-parameters */} There is no explicit limit to the total number of parameters that an [Activity Definition](/activity-definition) may support. However, there is a limit to the total size of the data that ends up encoded into a gRPC message Payload. diff --git a/docs/develop/php/activities/execution.mdx b/docs/develop/php/activities/execution.mdx index 63bda7f690..c78d012ed5 100644 --- a/docs/develop/php/activities/execution.mdx +++ b/docs/develop/php/activities/execution.mdx @@ -1,7 +1,7 @@ --- id: execution -title: Activity execution - PHP SDK -description: Shows how to perform Activity execution with the PHP SDK +title: Activity Execution - PHP SDK +description: Call an Activity from a PHP Workflow through a stub created with newActivityStub, set the required Timeout, and get the Activity result. sidebar_label: Activity Execution slug: /develop/php/activities/execution toc_max_heading_level: 3 @@ -21,7 +21,7 @@ A single instance of the Activities implementation is shared across multiple sim Activity implementation code should be _idempotent_. The values passed to Activities through invocation parameters or returned through a result value are recorded in the Execution history. -The entire Execution history is transferred from the Temporal service to Workflow Workers when a Workflow state needs to recover. +The entire Execution history is transferred from the Temporal Service to Workflow Workers when a Workflow state needs to recover. A large Execution history can thus adversely impact the performance of your Workflow. Therefore, be mindful of the amount of data you transfer through Activity invocation parameters or Return Values. diff --git a/docs/develop/php/activities/index.mdx b/docs/develop/php/activities/index.mdx index 7044c23dbe..bfb368b2ff 100644 --- a/docs/develop/php/activities/index.mdx +++ b/docs/develop/php/activities/index.mdx @@ -2,7 +2,7 @@ id: index title: Activities - PHP SDK sidebar_label: Activities -description: This section explains how to implement Activities with the PHP SDK +description: Activity Definitions, Activity Execution, Activity Timeouts, and Asynchronous Activity Completion in the Temporal PHP SDK. toc_max_heading_level: 4 tags: - Activities @@ -21,6 +21,6 @@ import * as Components from '@site/src/components'; ## Activities - [Activity basics](/develop/php/activities/basics) -- [Activity execution](/develop/php/activities/execution) +- [Activity Execution](/develop/php/activities/execution) - [Timeouts](/develop/php/activities/timeouts) - [Asynchronous Activity Completion](/develop/php/activities/asynchronous-activity) diff --git a/docs/develop/php/activities/timeouts.mdx b/docs/develop/php/activities/timeouts.mdx index f4cc60ced7..32d9843066 100644 --- a/docs/develop/php/activities/timeouts.mdx +++ b/docs/develop/php/activities/timeouts.mdx @@ -76,7 +76,7 @@ Activity Execution semantics rely on several parameters. The only required value that needs to be set is either a [Schedule-To-Close Timeout](/encyclopedia/detecting-activity-failures#start-to-close-timeout) or a [Start-To-Close Timeout](/encyclopedia/detecting-activity-failures#start-to-close-timeout). These values are set in the Activity Options. -## Activity next retry delay {/* #activity-next-retry-delay */} +### Activity next retry delay {/* #activity-next-retry-delay */} You may throw an [`ApplicationFailure`](/references/failures#application-failure) with the `nextRetryDelay` field set. This value will replace and override whatever the retry interval would be on the retry policy. diff --git a/docs/develop/python/activities/basics.mdx b/docs/develop/python/activities/basics.mdx index 67441835f1..e398529071 100644 --- a/docs/develop/python/activities/basics.mdx +++ b/docs/develop/python/activities/basics.mdx @@ -2,7 +2,7 @@ id: basics title: Activity basics - Python SDK sidebar_label: Activity basics -description: This section explains Activity basics with the Python SDK +description: Define an Activity with the activity.defn decorator, pass a single dataclass parameter, return serializable data, and set a custom Activity Type. toc_max_heading_level: 4 tags: - Activities @@ -57,7 +57,7 @@ async def your_activity(input: YourParams) -> str: return f"{input.greeting}, {input.name}!" ``` -### Develop Activity parameters {/* #activity-parameters */} +### Define Activity parameters {/* #activity-parameters */} There is no explicit limit to the total number of parameters that an [Activity Definition](/activity-definition) may support. However, there is a limit to the total size of the data that ends up encoded into a gRPC message Payload. diff --git a/docs/develop/python/activities/execution.mdx b/docs/develop/python/activities/execution.mdx index 7ec36dbea5..e6365da201 100644 --- a/docs/develop/python/activities/execution.mdx +++ b/docs/develop/python/activities/execution.mdx @@ -1,8 +1,8 @@ --- id: execution -title: Activity execution - Python SDK -description: Shows how to perform Activity execution with the Python SDK -sidebar_label: Activity execution +title: Activity Execution - Python SDK +description: Call an Activity from a Python Workflow with workflow.execute_activity, set the required Timeout, and await the Activity result. +sidebar_label: Activity Execution slug: /develop/python/activities/execution toc_max_heading_level: 3 tags: @@ -17,14 +17,14 @@ Calls to spawn [Activity Executions](/activity-execution) are written within a [Workflow Definition](/workflow-definition). The call to spawn an Activity Execution generates the [ScheduleActivityTask](/references/commands#scheduleactivitytask) Command. This results in the set of three [Activity Task](/tasks#activity-task) related Events ([ActivityTaskScheduled](/references/events#activitytaskscheduled), -[ActivityTaskStarted](/references/events#activitytaskstarted), and ActivityTask[Closed])in your Workflow Execution Event +[ActivityTaskStarted](/references/events#activitytaskstarted), and ActivityTask[Closed]) in your Workflow Execution Event History. A single instance of the Activities implementation is shared across multiple simultaneous Activity invocations. Activity implementation code should be _idempotent_. The values passed to Activities through invocation parameters or returned through a result value are recorded in the -Execution history. The entire Execution history is transferred from the Temporal service to Workflow Workers when a +Execution history. The entire Execution history is transferred from the Temporal Service to Workflow Workers when a Workflow state needs to recover. A large Execution history can thus adversely impact the performance of your Workflow. Therefore, be mindful of the amount of data you transfer through Activity invocation parameters or Return Values. diff --git a/docs/develop/python/activities/index.mdx b/docs/develop/python/activities/index.mdx index f4a4c0f496..e741d913c5 100644 --- a/docs/develop/python/activities/index.mdx +++ b/docs/develop/python/activities/index.mdx @@ -2,7 +2,7 @@ id: index title: Activities - Python SDK sidebar_label: Activities -description: This section explains how to implement Activities with the Python SDK +description: Activity Definitions, Activity Execution, Timeouts, Standalone Activities, and benign exceptions in the Temporal Python SDK. toc_max_heading_level: 4 tags: - Activities @@ -21,7 +21,7 @@ import * as Components from '@site/src/components'; ## Activities - [Activity basics](/develop/python/activities/basics) -- [Activity execution](/develop/python/activities/execution) +- [Activity Execution](/develop/python/activities/execution) - [Standalone Activities Quickstart](/develop/python/activities/standalone-activities-quickstart) - [Standalone Activities Feature Guide](/develop/python/activities/standalone-activities) - [Timeouts](/develop/python/activities/timeouts) diff --git a/docs/develop/python/index.mdx b/docs/develop/python/index.mdx index c44acbf4d0..22ff1019e0 100644 --- a/docs/develop/python/index.mdx +++ b/docs/develop/python/index.mdx @@ -27,7 +27,7 @@ Once your local Temporal Service is set up, continue building with the following - [Activity basics](/develop/python/activities/basics) - [Workflow basics](/develop/python/workflows/basics) -- [Start an Activity execution](/develop/python/activities/execution) +- [Start an Activity Execution](/develop/python/activities/execution) - [Run Worker processes](/develop/python/workers/run-worker-process) From there, you can dive deeper into any of the Temporal primitives to start building Workflows that fit your use cases. @@ -48,7 +48,7 @@ From there, you can dive deeper into any of the Temporal primitives to start bui ## [Activities](/develop/python/activities) - [Activity basics](/develop/python/activities/basics) -- [Activity execution](/develop/python/activities/execution) +- [Activity Execution](/develop/python/activities/execution) - [Standalone Activities](/develop/python/activities/standalone-activities-quickstart) - [Timeouts](/develop/python/activities/timeouts) - [Asynchronous Activity completion](/develop/python/activities/asynchronous-activity) diff --git a/docs/develop/ruby/activities/basics.mdx b/docs/develop/ruby/activities/basics.mdx index 436cf99eaa..57d72450d0 100644 --- a/docs/develop/ruby/activities/basics.mdx +++ b/docs/develop/ruby/activities/basics.mdx @@ -2,7 +2,7 @@ id: basics title: Activity basics - Ruby SDK sidebar_label: Activity basics -description: This section explains Activity basics with the Ruby SDK +description: Define an Activity as a class that extends Temporalio::Activity::Definition, name it, and pick the executor that controls Activity concurrency. toc_max_heading_level: 4 tags: - Activities @@ -14,7 +14,7 @@ tags: One of the primary things that Workflows do is orchestrate the execution of Activities. An Activity is a normal method execution that's intended to execute a single, well-defined action (either short or long-running), such as querying a database, calling a third-party API, or transcoding a media file. -An Activity can interact with world outside the Temporal Platform or use a Temporal Client to interact with a Temporal Service. +An Activity can interact with the world outside the Temporal Platform or use a Temporal Client to interact with a Temporal Service. For the Workflow to be able to execute the Activity, we must define the [Activity Definition](/activity-definition). Standalone Activities are Activities that run independently, without being orchestrated by a Workflow. Instead of starting an Activity from within a Workflow Definition, you start a Standalone Activity directly from a Temporal Client. diff --git a/docs/develop/ruby/activities/dynamic-activity.mdx b/docs/develop/ruby/activities/dynamic-activity.mdx index b73eea333c..fa37910e76 100644 --- a/docs/develop/ruby/activities/dynamic-activity.mdx +++ b/docs/develop/ruby/activities/dynamic-activity.mdx @@ -2,7 +2,7 @@ id: dynamic-activity title: Dynamic Activities - Ruby SDK sidebar_label: Dynamic Activities -description: This section explains Dynamic Activities with the Ruby SDK +description: Register one Dynamic Activity per Worker with activity_dynamic to handle Activity Types that match no other registered Activity. toc_max_heading_level: 4 tags: - Activities diff --git a/docs/develop/ruby/activities/execution.mdx b/docs/develop/ruby/activities/execution.mdx index 5b45db28da..a62643402f 100644 --- a/docs/develop/ruby/activities/execution.mdx +++ b/docs/develop/ruby/activities/execution.mdx @@ -1,8 +1,8 @@ --- id: execution -title: Activity execution - Ruby SDK -description: Shows how to perform Activity execution with the Ruby SDK -sidebar_label: Activity execution +title: Activity Execution - Ruby SDK +description: Call an Activity from a Ruby Workflow with Temporalio::Workflow.execute_activity and set the required Schedule-To-Close or Start-To-Close Timeout. +sidebar_label: Activity Execution slug: /develop/ruby/activities/execution toc_max_heading_level: 3 tags: @@ -11,14 +11,14 @@ tags: - Temporal SDKs --- -## Start Activity Execution {/* #activity-execution */} +## Start an Activity Execution {/* #activity-execution */} Calls to spawn [Activity Executions](/activity-execution) are written within a [Workflow Definition](/workflow-definition). The call to spawn an Activity Execution generates the [ScheduleActivityTask](/references/commands#scheduleactivitytask) Command. -This results in the set of three [Activity Task](/tasks#activity-task) related Events ([ActivityTaskScheduled](/references/events#activitytaskscheduled), [ActivityTaskStarted](/references/events#activitytaskstarted), and `ActivityTask[Closed]`)in your Workflow Execution Event History. +This results in the set of three [Activity Task](/tasks#activity-task) related Events ([ActivityTaskScheduled](/references/events#activitytaskscheduled), [ActivityTaskStarted](/references/events#activitytaskstarted), and `ActivityTask[Closed]`) in your Workflow Execution Event History. The values passed to Activities through invocation parameters or returned through a result value are recorded in the Execution history. -The entire Execution history is transferred from the Temporal service to Workflow Workers when a Workflow state needs to recover. +The entire Execution history is transferred from the Temporal Service to Workflow Workers when a Workflow state needs to recover. A large Execution history can thus adversely impact the performance of your Workflow. Therefore, be mindful of the amount of data you transfer through Activity invocation parameters or Return Values. @@ -45,4 +45,4 @@ Activity Execution semantics rely on several parameters. The only required value that needs to be set is either a [Schedule-To-Close Timeout](/encyclopedia/detecting-activity-failures#schedule-to-close-timeout) or a [Start-To-Close Timeout](/encyclopedia/detecting-activity-failures#start-to-close-timeout). These values are set as keyword parameters. -The Activity result is the returned from the `execute_activity` call. +The Activity result is returned from the `execute_activity` call. diff --git a/docs/develop/ruby/activities/index.mdx b/docs/develop/ruby/activities/index.mdx index 076fec5e09..4498fba02a 100644 --- a/docs/develop/ruby/activities/index.mdx +++ b/docs/develop/ruby/activities/index.mdx @@ -2,7 +2,7 @@ id: index title: Activities - Ruby SDK sidebar_label: Activities -description: This section explains how to implement Activities with the Ruby SDK +description: Activity Definitions, Activity Execution, Timeouts, Standalone Activities, Dynamic Activities, and benign exceptions in the Temporal Ruby SDK. toc_max_heading_level: 4 tags: - Activities @@ -21,7 +21,7 @@ import * as Components from '@site/src/components'; ## Activities - [Activity basics](/develop/ruby/activities/basics) -- [Activity execution](/develop/ruby/activities/execution) +- [Activity Execution](/develop/ruby/activities/execution) - [Standalone Activities Quickstart](/develop/ruby/activities/standalone-activities-quickstart) - [Standalone Activities Feature Guide](/develop/ruby/activities/standalone-activities) - [Timeouts](/develop/ruby/activities/timeouts) diff --git a/docs/develop/ruby/index.mdx b/docs/develop/ruby/index.mdx index ad50a4e762..5c885cdc66 100644 --- a/docs/develop/ruby/index.mdx +++ b/docs/develop/ruby/index.mdx @@ -31,7 +31,7 @@ Once your local Temporal Service is set up, continue building with the following - [Workflow basics](/develop/ruby/workflows/basics) - [Activity basics](/develop/ruby/activities/basics) -- [Start an Activity execution](/develop/ruby/activities/execution) +- [Start an Activity Execution](/develop/ruby/activities/execution) - [Run Worker processes](/develop/ruby/workers/run-worker-process) From there, you can dive deeper into any of the Temporal primitives to start building Workflows that fit your use cases. @@ -53,7 +53,7 @@ From there, you can dive deeper into any of the Temporal primitives to start bui ## [Activities](/develop/ruby/activities) - [Activity basics](/develop/ruby/activities/basics) -- [Activity execution](/develop/ruby/activities/execution) +- [Activity Execution](/develop/ruby/activities/execution) - [Standalone Activities](/develop/ruby/activities/standalone-activities-quickstart) - [Timeouts](/develop/ruby/activities/timeouts) - [Asynchronous Activity completion](/develop/ruby/activities/asynchronous-activity) diff --git a/docs/develop/rust/activities/basics.mdx b/docs/develop/rust/activities/basics.mdx index 0431c67621..b13d269fe0 100644 --- a/docs/develop/rust/activities/basics.mdx +++ b/docs/develop/rust/activities/basics.mdx @@ -2,7 +2,7 @@ id: basics title: Activity basics - Rust SDK sidebar_label: Activity basics -description: This section explains Activity basics with the Rust SDK +description: Define an Activity as a Rust function, set its parameters and serializable return values, and give its Activity Type a custom name. toc_max_heading_level: 4 tags: - Activities diff --git a/docs/develop/rust/activities/execution.mdx b/docs/develop/rust/activities/execution.mdx index cadd6a1742..b836e4f04c 100644 --- a/docs/develop/rust/activities/execution.mdx +++ b/docs/develop/rust/activities/execution.mdx @@ -1,8 +1,8 @@ --- id: execution -title: Activity execution - Rust SDK -description: Shows how to perform Activity execution with the Rust SDK -sidebar_label: Activity execution +title: Activity Execution - Rust SDK +description: Call an Activity from a Rust Workflow with ctx.execute_activity, set the required Timeout, and await the Future it returns. +sidebar_label: Activity Execution slug: /develop/rust/activities/execution toc_max_heading_level: 3 tags: diff --git a/docs/develop/rust/activities/index.mdx b/docs/develop/rust/activities/index.mdx index 6707ff491c..1c01b9c937 100644 --- a/docs/develop/rust/activities/index.mdx +++ b/docs/develop/rust/activities/index.mdx @@ -2,8 +2,7 @@ id: index title: Activities - Rust SDK sidebar_label: Activities -description: - This section explains how to implement Activities with the Rust SDK +description: Activity Definitions, Activity Execution, and Activity Timeouts in the Temporal Rust SDK, including Retry Policies and Heartbeats. toc_max_heading_level: 4 tags: - Activities @@ -22,5 +21,5 @@ import * as Components from '@site/src/components'; ## Activities - [Activity basics](/develop/rust/activities/basics) -- [Activity execution](/develop/rust/activities/execution) +- [Activity Execution](/develop/rust/activities/execution) - [Timeouts](/develop/rust/activities/timeouts) diff --git a/docs/develop/rust/index.mdx b/docs/develop/rust/index.mdx index 61c03ba94b..d630d7a0d5 100644 --- a/docs/develop/rust/index.mdx +++ b/docs/develop/rust/index.mdx @@ -26,7 +26,7 @@ Once your local Temporal Service is set up, continue building with the following - [Develop a Workflow](/develop/rust/workflows/basics) - [Develop an Activity](/develop/rust/activities/basics) -- [Start an Activity execution](/develop/rust/activities/execution) +- [Start an Activity Execution](/develop/rust/activities/execution) - [Run Worker processes](/develop/rust/workers/worker-process) ## [Workflows](/develop/rust/workflows) @@ -42,7 +42,7 @@ Once your local Temporal Service is set up, continue building with the following ## [Activities](/develop/rust/activities) - [Activity basics](/develop/rust/activities/basics) -- [Activity execution](/develop/rust/activities/execution) +- [Activity Execution](/develop/rust/activities/execution) - [Timeouts](/develop/rust/activities/timeouts) ## [Workers](/develop/rust/workers) diff --git a/docs/develop/typescript/activities/basics.mdx b/docs/develop/typescript/activities/basics.mdx index b514659a34..f67184f460 100644 --- a/docs/develop/typescript/activities/basics.mdx +++ b/docs/develop/typescript/activities/basics.mdx @@ -1,7 +1,7 @@ --- id: basics title: Activity basics - TypeScript SDK -description: Shows how to create an Activity with the TypeScript SDK +description: Export an Activity as an async TypeScript function, type its parameters and return value, and share dependencies through dependency injection. sidebar_label: Activity basics slug: /develop/typescript/activities/basics toc_max_heading_level: 3 @@ -15,7 +15,7 @@ tags: One of the primary things that Workflows do is orchestrate the execution of Activities. An Activity is a normal function or method execution that's intended to execute a single, well-defined action (either short or long-running), such as -querying a database, calling a third-party API, or transcoding a media file. An Activity can interact with world outside +querying a database, calling a third-party API, or transcoding a media file. An Activity can interact with the world outside the Temporal Platform or use a Temporal Client to interact with a Temporal Service. For the Workflow to be able to execute the Activity, we must define the [Activity Definition](/activity-definition). @@ -38,7 +38,7 @@ export async function greet(name: string): Promise { ``` -## Develop Activity parameters {/* #activity-parameters */} +## Define Activity parameters {/* #activity-parameters */} There is no explicit limit to the total number of parameters that an [Activity Definition](/activity-definition) may support. However, there is a limit to the total size of the data that ends up encoded into a gRPC message Payload. diff --git a/docs/develop/typescript/activities/execution.mdx b/docs/develop/typescript/activities/execution.mdx index d1a9ab02e1..ac45cb4066 100644 --- a/docs/develop/typescript/activities/execution.mdx +++ b/docs/develop/typescript/activities/execution.mdx @@ -1,8 +1,8 @@ --- id: execution -title: Activity execution - TypeScript SDK -description: Shows how to perform Activity execution with the TypeScript SDK -sidebar_label: Activity execution +title: Activity Execution - TypeScript SDK +description: Call an Activity from a TypeScript Workflow through proxyActivities, set the required Timeout, and keep Activity inputs and results small. +sidebar_label: Activity Execution slug: /develop/typescript/activities/execution toc_max_heading_level: 3 tags: diff --git a/docs/develop/typescript/activities/index.mdx b/docs/develop/typescript/activities/index.mdx index 052bd97061..bffff65b86 100644 --- a/docs/develop/typescript/activities/index.mdx +++ b/docs/develop/typescript/activities/index.mdx @@ -2,7 +2,7 @@ id: index title: Activities - TypeScript SDK sidebar_label: Activities -description: This section explains how to implement Activities with the TypeScript SDK +description: Activity Definitions, Activity Execution, Timeouts, Standalone Activities, and benign exceptions in the Temporal TypeScript SDK. toc_max_heading_level: 4 tags: - Activities @@ -21,7 +21,7 @@ import * as Components from '@site/src/components'; ## Activities - [Activity basics](/develop/typescript/activities/basics) -- [Activity execution](/develop/typescript/activities/execution) +- [Activity Execution](/develop/typescript/activities/execution) - [Standalone Activities Quickstart](/develop/typescript/activities/standalone-activities-quickstart) - [Standalone Activities Feature Guide](/develop/typescript/activities/standalone-activities) - [Timeouts](/develop/typescript/activities/timeouts) diff --git a/docs/develop/typescript/activities/timeouts.mdx b/docs/develop/typescript/activities/timeouts.mdx index 0a4aa3de26..0f871fd00c 100644 --- a/docs/develop/typescript/activities/timeouts.mdx +++ b/docs/develop/typescript/activities/timeouts.mdx @@ -47,7 +47,7 @@ const { myActivity } = proxyActivities({ }); ``` -## Activity Retry Policy {/* #activity-retries */} +### Activity Retry Policy {/* #activity-retries */} A Retry Policy works in cooperation with the timeouts to provide fine controls to optimize the execution experience. @@ -65,7 +65,7 @@ const { myActivity } = proxyActivities({ }); ``` -## Activity next retry delay {/* #activity-next-retry-delay */} +### Activity next retry delay {/* #activity-next-retry-delay */} The time to wait after a retryable Activity failure until the next retry is attempted is normally determined by that Activity's Retry Policy. However, an Activity may override that duration when explicitly failing with an [`ApplicationFailure`](https://typescript.temporal.io/api/classes/common.ApplicationFailure) by setting a next Retry delay. @@ -135,7 +135,7 @@ export async function myActivity(): Promise { } ``` -## Activity Heartbeat Timeout {/* #activity-heartbeat-timeout */} +### Activity Heartbeat Timeout {/* #activity-heartbeat-timeout */} A [Heartbeat Timeout](/encyclopedia/detecting-activity-failures#heartbeat-timeout) works in conjunction with [Activity Heartbeats](/encyclopedia/detecting-activity-failures#activity-heartbeat). If the Temporal Server doesn't receive a Heartbeat before expiration of the Heartbeat Timeout, the Activity is considered as timed out and another [Activity Task Execution](/tasks#activity-task-execution) may be scheduled according to the Retry Policy. diff --git a/docs/develop/typescript/index.mdx b/docs/develop/typescript/index.mdx index 76937c32c9..c292cbc787 100644 --- a/docs/develop/typescript/index.mdx +++ b/docs/develop/typescript/index.mdx @@ -29,7 +29,7 @@ Once your local Temporal Service is set up, continue building with the following - [Develop a Workflow](/develop/typescript/workflows/basics) - [Develop an Activity](/develop/typescript/activities/basics) -- [Start an Activity execution](/develop/typescript/activities/execution) +- [Start an Activity Execution](/develop/typescript/activities/execution) - [Run Worker processes](/develop/typescript/workers/run-worker-process) ## [Workflows](/develop/typescript/workflows) @@ -49,7 +49,7 @@ Once your local Temporal Service is set up, continue building with the following ## [Activities](/develop/typescript/activities) - [Activity basics](/develop/typescript/activities/basics) -- [Activity execution](/develop/typescript/activities/execution) +- [Activity Execution](/develop/typescript/activities/execution) - [Timeouts](/develop/typescript/activities/timeouts) - [Asynchronous Activity](/develop/typescript/activities/asynchronous-activity) - [Benign exceptions](/develop/typescript/activities/benign-exceptions) From 93013f196a3c15264fc605d5c6b6cb716c5e663d Mon Sep 17 00:00:00 2001 From: Jwahir Sundai Date: Tue, 15 Sep 2026 15:30:16 -0500 Subject: [PATCH 7/7] Remove how-to phrasing from the Activities section Delete the page-announcing sentences on the asynchronous Activity pages and the duplicate section list on the TypeScript timeouts page, relabel 'How to' links and next-step bullets, and rewrite example lead-ins to state what the example does. --- docs/develop/dotnet/activities/asynchronous-activity.mdx | 2 -- .../activities/standalone-activities-quickstart.mdx | 8 ++++---- .../go/activities/standalone-activities-quickstart.mdx | 8 ++++---- docs/develop/java/activities/asynchronous-activity.mdx | 2 -- docs/develop/java/activities/basics.mdx | 2 +- docs/develop/java/activities/execution.mdx | 6 +++--- .../java/activities/standalone-activities-quickstart.mdx | 4 ++-- docs/develop/php/activities/asynchronous-activity.mdx | 2 +- docs/develop/php/activities/basics.mdx | 2 +- docs/develop/python/activities/basics.mdx | 4 ++-- .../activities/standalone-activities-quickstart.mdx | 6 +++--- docs/develop/ruby/activities/asynchronous-activity.mdx | 2 -- .../ruby/activities/standalone-activities-quickstart.mdx | 4 ++-- docs/develop/typescript/activities/basics.mdx | 4 ++-- .../activities/standalone-activities-quickstart.mdx | 8 ++++---- .../typescript/activities/standalone-activities.mdx | 4 ++-- docs/develop/typescript/activities/timeouts.mdx | 8 -------- 17 files changed, 31 insertions(+), 45 deletions(-) diff --git a/docs/develop/dotnet/activities/asynchronous-activity.mdx b/docs/develop/dotnet/activities/asynchronous-activity.mdx index cf884bf7c8..51fb521132 100644 --- a/docs/develop/dotnet/activities/asynchronous-activity.mdx +++ b/docs/develop/dotnet/activities/asynchronous-activity.mdx @@ -10,8 +10,6 @@ tags: - Temporal SDKs --- -This page describes how to asynchronously complete an Activity. - [Asynchronous Activity Completion](/activity-execution#asynchronous-activity-completion) enables the Activity Function to return without the Activity Execution completing. There are three steps to follow: diff --git a/docs/develop/dotnet/activities/standalone-activities-quickstart.mdx b/docs/develop/dotnet/activities/standalone-activities-quickstart.mdx index d60410f1ab..06bf218d51 100644 --- a/docs/develop/dotnet/activities/standalone-activities-quickstart.mdx +++ b/docs/develop/dotnet/activities/standalone-activities-quickstart.mdx @@ -162,9 +162,9 @@ await worker.ExecuteAsync(tokenSource.Token);`} Running a Worker for Standalone Activities is the same as running a Worker for Workflow Activities — you create a Worker, register the Activity, and run the Worker. The Worker doesn't need to know -whether the Activity will be invoked from a Workflow or as a Standalone Activity. See [How to develop -a Worker](/develop/dotnet/workers/run-worker-process) for more details on Worker setup and -configuration options. +whether the Activity will be invoked from a Workflow or as a Standalone Activity. See +[Develop a Worker](/develop/dotnet/workers/run-worker-process) for more details on Worker setup and configuration +options. [src/StandaloneActivity/Program.cs](https://github.com/temporalio/samples-dotnet/blob/main/src/StandaloneActivity/Program.cs) @@ -270,4 +270,4 @@ for mTLS and API key setup. ## Next steps - **[Standalone Activities Feature Guide](/develop/dotnet/activities/standalone-activities)**: Start without waiting, get handles, list and count Activities, and connect to Temporal Cloud. -- **[Activity basics](/develop/dotnet/activities/basics)**: How to write and register Activities with the .NET SDK. +- **[Activity basics](/develop/dotnet/activities/basics)**: Write and register Activities with the .NET SDK. diff --git a/docs/develop/go/activities/standalone-activities-quickstart.mdx b/docs/develop/go/activities/standalone-activities-quickstart.mdx index cecd7f9933..7ac01a88a4 100644 --- a/docs/develop/go/activities/standalone-activities-quickstart.mdx +++ b/docs/develop/go/activities/standalone-activities-quickstart.mdx @@ -159,7 +159,7 @@ Running a Worker for Standalone Activities is the same as running a Worker for W Worker, register the Activity, and call `Run()`. The Worker doesn't need to know whether the Activity will be invoked from a Workflow or as a Standalone Activity. -See [How to develop a Worker in Go](/develop/go/workers/run-worker-process#develop-worker) for more details on Worker setup and +See [Develop a Worker in Go](/develop/go/workers/run-worker-process#develop-worker) for more details on Worker setup and configuration options. [standalone-activity/helloworld/worker/main.go](https://github.com/temporalio/samples-go/blob/main/standalone-activity/helloworld/worker/main.go) @@ -258,8 +258,8 @@ Execution. This is called from application code (for example, a starter program) `ExecuteActivity` returns an [`ActivityHandle`](https://pkg.go.dev/go.temporal.io/sdk/client#ActivityHandle) that you can use to get the result, describe, cancel, or terminate the Activity. -The following starter program demonstrates how to execute a Standalone Activity, get its result, list activities, and -count activities: +The following starter program executes a Standalone Activity, gets its result, lists activities, and counts +activities: Create [standalone-activity/helloworld/starter/main.go](https://github.com/temporalio/samples-go/blob/main/standalone-activity/helloworld/starter/main.go). @@ -306,4 +306,4 @@ for mTLS and API key setup. - **[Standalone Activities Feature Guide](/develop/go/activities/standalone-activities)**: Get results, Activity handles, list and count Activities, and connect to Temporal Cloud. - **[Build a Job Queue with Standalone Activities](https://learn.temporal.io/tutorials/go/standalone-activities/)**: Tutorial that builds a durable job queue, with idempotency keys, server-side deduplication, throughput limits, [Priority and Fairness](/develop/task-queue-priority-fairness), and heartbeat checkpoints. -- **[Activity basics](/develop/go/activities/basics)**: How to write and register Activities with the Go SDK. +- **[Activity basics](/develop/go/activities/basics)**: Write and register Activities with the Go SDK. diff --git a/docs/develop/java/activities/asynchronous-activity.mdx b/docs/develop/java/activities/asynchronous-activity.mdx index 6166efe50f..27d0041d81 100644 --- a/docs/develop/java/activities/asynchronous-activity.mdx +++ b/docs/develop/java/activities/asynchronous-activity.mdx @@ -10,8 +10,6 @@ tags: description: Asynchronously complete an Activity in a Workflow with Temporal. Follow steps to provide identifying information, use Temporal Client, and set the complete() method. --- -This page shows how to asynchronously complete an Activity - [Asynchronous Activity Completion](/activity-execution#asynchronous-activity-completion) enables the Activity Function to return without the Activity Execution completing. There are three steps to follow: diff --git a/docs/develop/java/activities/basics.mdx b/docs/develop/java/activities/basics.mdx index 4b91098358..4edc15096a 100644 --- a/docs/develop/java/activities/basics.mdx +++ b/docs/develop/java/activities/basics.mdx @@ -137,7 +137,7 @@ They also support code management, especially in larger projects with many Activ For example, you might use a prefix to group related activities together. Custom names also distinguish keys for gathering metrics without name conflicts. -The following examples show how to set custom names for your Activity Type. +The following examples set custom names for your Activity Type. ### Default behavior diff --git a/docs/develop/java/activities/execution.mdx b/docs/develop/java/activities/execution.mdx index 36c556c0bd..941d3de747 100644 --- a/docs/develop/java/activities/execution.mdx +++ b/docs/develop/java/activities/execution.mdx @@ -33,7 +33,7 @@ Activities are not executable on their own. You cannot start an Activity Executi Note that before an Activity Execution is invoked: - Activity options (either [`setStartToCloseTimeout`](/encyclopedia/detecting-activity-failures#start-to-close-timeout) or [`ScheduleToCloseTimeout`](/encyclopedia/detecting-activity-failures#schedule-to-close-timeout) are required) must be set for the Activity. - For details, see [How to set Activity timeouts](/develop/java/activities/timeouts). + For details, see [Activity Timeouts](/develop/java/activities/timeouts). - The Activity must be registered with a Worker. See [Worker Program](/develop/java/workers/run-worker-process#run-a-dev-worker) - Activity code must be thread-safe. @@ -131,7 +131,7 @@ In the following asynchronous Activity invocation, the method reference is passe Promise localNamePromise = Async.function(activities::download, sourceBucket, sourceFile); ``` -The following example shows how to call two Activity methods, "download" and "upload", in parallel on multiple files. +The following example calls two Activity methods, "download" and "upload", in parallel on multiple files. ```java public void processFile(Arguments args) { @@ -265,7 +265,7 @@ If you define options per-Activity Type options with `WorkflowImplementationOpti ## Java ActivityOptions reference {/* #activity-options-reference */} -Use [`ActivityOptions`](https://www.javadoc.io/doc/io.temporal/temporal-sdk/latest/io/temporal/activity/ActivityOptions.Builder.html) to configure how to invoke an Activity Execution. +Use [`ActivityOptions`](https://www.javadoc.io/doc/io.temporal/temporal-sdk/latest/io/temporal/activity/ActivityOptions.Builder.html) to configure an Activity Execution. You can set Activity Options using an `ActivityStub` within a Workflow implementation, or per-Activity using `WorkflowImplementationOptions` within a Worker. Note that if you define options per-Activity Type options with `WorkflowImplementationOptions.setActivityOptions()`, setting them again specifically with `ActivityStub` in a Workflow will override this setting. diff --git a/docs/develop/java/activities/standalone-activities-quickstart.mdx b/docs/develop/java/activities/standalone-activities-quickstart.mdx index 328ff23247..5196454d86 100644 --- a/docs/develop/java/activities/standalone-activities-quickstart.mdx +++ b/docs/develop/java/activities/standalone-activities-quickstart.mdx @@ -158,7 +158,7 @@ System.out.println("Worker running on task queue: " + TASK_QUEUE);`} Running a Worker for Standalone Activities is the same as running a Worker for Workflow Activities — you create a `WorkerFactory`, register the Activity implementation, and call `factory.start()`. The Worker doesn't need to know whether the Activity will be invoked from a Workflow or as a Standalone -Activity. See [How to run a Worker](/develop/java/workers/run-worker-process) for more details on +Activity. See [Run a Worker](/develop/java/workers/run-worker-process) for more details on Worker setup and configuration options. [StandaloneActivityWorker.java](https://github.com/temporalio/samples-java/blob/main/core/src/main/java/io/temporal/samples/standaloneactivities/StandaloneActivityWorker.java) @@ -258,4 +258,4 @@ for mTLS and API key setup. - **[Standalone Activities Feature Guide](/develop/java/activities/standalone-activities)**: Start without waiting, get handles, list and count Activities, and connect to Temporal Cloud. - **[Build a Job Queue with Standalone Activities](https://learn.temporal.io/tutorials/java/standalone-activities/)**: Tutorial that builds a durable job queue, with idempotency keys, server-side deduplication, throughput limits, [Priority and Fairness](/develop/task-queue-priority-fairness), and heartbeat checkpoints. -- **[Activity basics](/develop/java/activities/basics)**: How to write and register Activities with the Java SDK. +- **[Activity basics](/develop/java/activities/basics)**: Write and register Activities with the Java SDK. diff --git a/docs/develop/php/activities/asynchronous-activity.mdx b/docs/develop/php/activities/asynchronous-activity.mdx index 0a10728b54..1d5b2abe89 100644 --- a/docs/develop/php/activities/asynchronous-activity.mdx +++ b/docs/develop/php/activities/asynchronous-activity.mdx @@ -113,7 +113,7 @@ class GreetingActivity implements GreetingActivityInterface ``` -The following code demonstrates how to complete the Activity successfully using `WorkflowClient`: +The following code completes the Activity successfully using `WorkflowClient`: [app/src/AsyncActivityCompletion/CompleteCommand.php](https://github.com/temporalio/samples-php/blob/main/app/src/AsyncActivityCompletion/CompleteCommand.php) diff --git a/docs/develop/php/activities/basics.mdx b/docs/develop/php/activities/basics.mdx index 55aef95341..9aea9fa5a1 100644 --- a/docs/develop/php/activities/basics.mdx +++ b/docs/develop/php/activities/basics.mdx @@ -95,7 +95,7 @@ class GreetingActivity implements GreetingActivityInterface ### Customize your Activity Type {/* #activity-type */} Activities have a Type that are referred to as the Activity name. -The following examples demonstrate how to set a custom name for your Activity Type. +The following examples set a custom name for your Activity Type. An optional `#[ActivityMethod]` attribute can be used to override a default Activity name. diff --git a/docs/develop/python/activities/basics.mdx b/docs/develop/python/activities/basics.mdx index e398529071..f8d39f96a5 100644 --- a/docs/develop/python/activities/basics.mdx +++ b/docs/develop/python/activities/basics.mdx @@ -116,8 +116,8 @@ async def your_activity(input: YourParams) -> str: ### Customize your Activity Type {/* #activity-type */} -Activities have a Type that are referred to as the Activity name. The following examples demonstrate how to set a custom -name for your Activity Type. +Activities have a Type that are referred to as the Activity name. The following examples set a custom name for +your Activity Type. You can customize the Activity name with a custom name in the decorator argument. For example, `@activity.defn(name="your-activity")`. If the name parameter is not specified, the Activity name defaults to the diff --git a/docs/develop/python/activities/standalone-activities-quickstart.mdx b/docs/develop/python/activities/standalone-activities-quickstart.mdx index 26607461f7..6f4f87d48b 100644 --- a/docs/develop/python/activities/standalone-activities-quickstart.mdx +++ b/docs/develop/python/activities/standalone-activities-quickstart.mdx @@ -173,8 +173,8 @@ if __name__ == "__main__": Running a Worker for Standalone Activities is the same as running a Worker for Workflow Activities — you create a Worker, register the Activity, and run the Worker. The Worker doesn't need to know -whether the Activity will be invoked from a Workflow or as a Standalone Activity. See [How to run a -Worker](/develop/python/workers/run-worker-process#run-a-dev-worker) for more details on Worker setup and +whether the Activity will be invoked from a Workflow or as a Standalone Activity. See +[Run a Worker](/develop/python/workers/run-worker-process#run-a-dev-worker) for more details on Worker setup and configuration options. Create [hello_standalone_activity/worker.py](https://github.com/temporalio/samples-python/blob/main/hello_standalone_activity/worker.py). @@ -274,4 +274,4 @@ for mTLS and API key setup. - **[Standalone Activities Feature Guide](/develop/python/activities/standalone-activities)**: Start without waiting, get handles, list and count Activities, and connect to Temporal Cloud. - **[Build a Job Queue with Standalone Activities](https://learn.temporal.io/tutorials/python/standalone-activities/)**: Tutorial that builds a durable job queue, with idempotency keys, server-side deduplication, throughput limits, [Priority and Fairness](/develop/task-queue-priority-fairness), and heartbeat checkpoints. -- **[Activity basics](/develop/python/activities/basics)**: How to write and register Activities with the Python SDK. +- **[Activity basics](/develop/python/activities/basics)**: Write and register Activities with the Python SDK. diff --git a/docs/develop/ruby/activities/asynchronous-activity.mdx b/docs/develop/ruby/activities/asynchronous-activity.mdx index 546b1981ff..04d80ef02a 100644 --- a/docs/develop/ruby/activities/asynchronous-activity.mdx +++ b/docs/develop/ruby/activities/asynchronous-activity.mdx @@ -12,8 +12,6 @@ tags: ## Asynchronously complete an Activity {/* #asynchronous-activity-completion */} -This page describes how to asynchronously complete an Activity. - [Asynchronous Activity Completion](/activity-execution#asynchronous-activity-completion) enables the Activity Function to return without the Activity Execution completing. There are three steps to follow: diff --git a/docs/develop/ruby/activities/standalone-activities-quickstart.mdx b/docs/develop/ruby/activities/standalone-activities-quickstart.mdx index 8eacf53762..c821b95fb6 100644 --- a/docs/develop/ruby/activities/standalone-activities-quickstart.mdx +++ b/docs/develop/ruby/activities/standalone-activities-quickstart.mdx @@ -153,7 +153,7 @@ worker.run(shutdown_signals: ['SIGINT'])`} Running a Worker for Standalone Activities is the same as running a Worker for Workflow Activities — you create a [`Temporalio::Worker`](https://ruby.temporal.io/Temporalio/Worker.html), register the Activity class, and call `worker.run`. The Worker doesn't need to know whether the Activity will be invoked from a Workflow or as a Standalone -Activity. See [How to run a Worker](/develop/ruby/workers/run-worker-process) for more details on +Activity. See [Run a Worker](/develop/ruby/workers/run-worker-process) for more details on Worker setup and configuration options. [worker.rb](https://github.com/temporalio/samples-ruby/blob/main/standalone_activity/worker.rb) @@ -233,4 +233,4 @@ for mTLS and API key setup. ## Next steps - **[Standalone Activities Feature Guide](/develop/ruby/activities/standalone-activities)**: Start without waiting, get handles, list and count Activities, and connect to Temporal Cloud. -- **[Activity basics](/develop/ruby/activities/basics)**: How to write and register Activities with the Ruby SDK. +- **[Activity basics](/develop/ruby/activities/basics)**: Write and register Activities with the Ruby SDK. diff --git a/docs/develop/typescript/activities/basics.mdx b/docs/develop/typescript/activities/basics.mdx index f67184f460..7905329c38 100644 --- a/docs/develop/typescript/activities/basics.mdx +++ b/docs/develop/typescript/activities/basics.mdx @@ -90,8 +90,8 @@ export async function greet(name: string): Promise { ## Customize your Activity Type {/* #activity-type */} -Activities have a Type that are referred to as the Activity name. The following examples demonstrate how to set a custom -name for your Activity Type. +Activities have a Type that are referred to as the Activity name. The following examples set a custom name for +your Activity Type. You can customize the name of the Activity when you register it with the Worker. In the following example, the Activity Name is `activityFoo`. diff --git a/docs/develop/typescript/activities/standalone-activities-quickstart.mdx b/docs/develop/typescript/activities/standalone-activities-quickstart.mdx index c678d733a2..230326fd5b 100644 --- a/docs/develop/typescript/activities/standalone-activities-quickstart.mdx +++ b/docs/develop/typescript/activities/standalone-activities-quickstart.mdx @@ -152,9 +152,9 @@ run().catch((err) => { Running a Worker for Standalone Activities is the same as running a Worker for Workflow Activities — you create a Worker, register the Activity, and run the Worker. The Worker doesn't need to know -whether the Activity will be invoked from a Workflow or as a Standalone Activity. See [How to run a -Worker](/develop/typescript/workers/run-worker-process#run-a-dev-worker) for more details on Worker setup and -configuration options. +whether the Activity will be invoked from a Workflow or as a Standalone Activity. See +[Run a Worker](/develop/typescript/workers/run-worker-process#run-a-dev-worker) for more details on Worker setup +and configuration options. [standalone-activity/src/worker.ts](https://github.com/temporalio/samples-typescript/blob/main/standalone-activity/src/worker.ts) @@ -288,4 +288,4 @@ for mTLS and API key setup. - **[Standalone Activities Feature Guide](/develop/typescript/activities/standalone-activities)**: Start without waiting, get handles, list and count Activities, and connect to Temporal Cloud. - **[Build a Job Queue with Standalone Activities](https://learn.temporal.io/tutorials/typescript/standalone-activities/)**: Tutorial that builds a durable job queue, with idempotency keys, server-side deduplication, throughput limits, [Priority and Fairness](/develop/task-queue-priority-fairness), and heartbeat checkpoints. -- **[Activity basics](/develop/typescript/activities/basics)**: How to write and register Activities with the TypeScript SDK. +- **[Activity basics](/develop/typescript/activities/basics)**: Write and register Activities with the TypeScript SDK. diff --git a/docs/develop/typescript/activities/standalone-activities.mdx b/docs/develop/typescript/activities/standalone-activities.mdx index ff038c8ff2..60ed363ffd 100644 --- a/docs/develop/typescript/activities/standalone-activities.mdx +++ b/docs/develop/typescript/activities/standalone-activities.mdx @@ -142,7 +142,7 @@ for await (const a of client.activity.list(query)) { The sample file [standalone-activity/src/list.ts](https://github.com/temporalio/samples-typescript/blob/main/standalone-activity/src/list.ts) -shows how to list and count activities. +lists and counts activities. Run it: @@ -179,7 +179,7 @@ console.log(`Total activities: ${count}`); The sample file [standalone-activity/src/list.ts](https://github.com/temporalio/samples-typescript/blob/main/standalone-activity/src/list.ts) -shows how to list and count activities. +lists and counts activities. Run it: diff --git a/docs/develop/typescript/activities/timeouts.mdx b/docs/develop/typescript/activities/timeouts.mdx index 0f871fd00c..4fd0ddbe0f 100644 --- a/docs/develop/typescript/activities/timeouts.mdx +++ b/docs/develop/typescript/activities/timeouts.mdx @@ -13,14 +13,6 @@ tags: - Temporal SDKs --- -This page shows how to do the following: - -- [Activity Timeouts](#activity-timeouts) -- [Activity Retry Policy](#activity-retries) -- [Activity next retry delay](#activity-next-retry-delay) -- [Heartbeat an Activity](#activity-heartbeats) -- [Activity Heartbeat Timeout](#activity-heartbeat-timeout) - ## Activity Timeouts {/* #activity-timeouts */} Each Activity Timeout controls the maximum duration of a different aspect of an Activity Execution.