Skip to content
2 changes: 0 additions & 2 deletions docs/develop/dotnet/activities/asynchronous-activity.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down
5 changes: 3 additions & 2 deletions docs/develop/dotnet/activities/basics.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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 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
- .NET SDK
- Temporal SDKs
---
Expand All @@ -13,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.
Expand Down
2 changes: 1 addition & 1 deletion docs/develop/dotnet/activities/benign-exceptions.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
3 changes: 2 additions & 1 deletion docs/develop/dotnet/activities/dynamic-activity.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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 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
- .NET SDK
- Temporal SDKs
---
Expand Down
14 changes: 7 additions & 7 deletions docs/develop/dotnet/activities/execution.mdx
Original file line number Diff line number Diff line change
@@ -1,17 +1,17 @@
---
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:
- Activities
- .NET SDK
- Temporal SDKs
- Activities
---

## 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.
Expand All @@ -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.
Expand Down Expand Up @@ -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.
5 changes: 3 additions & 2 deletions docs/develop/dotnet/activities/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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: Activity Definitions, Activity Execution, Timeouts, Standalone Activities, Dynamic Activities, and benign exceptions in the Temporal .NET SDK.
toc_max_heading_level: 4
tags:
- Activities
- .NET SDK
- Temporal SDKs
---
Expand All @@ -20,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)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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)

Expand Down Expand Up @@ -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.
2 changes: 1 addition & 1 deletion docs/develop/dotnet/activities/timeouts.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
4 changes: 2 additions & 2 deletions docs/develop/dotnet/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand All @@ -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)
Expand Down
11 changes: 6 additions & 5 deletions docs/develop/go/activities/basics.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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: 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
- 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.

Expand Down Expand Up @@ -71,7 +72,7 @@ func (a *YourActivityObject) YourActivityDefinition(ctx context.Context, param Y
}
```

### 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.
Expand Down Expand Up @@ -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.

Expand Down Expand Up @@ -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.

Expand Down
2 changes: 1 addition & 1 deletion docs/develop/go/activities/benign-exceptions.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
3 changes: 2 additions & 1 deletion docs/develop/go/activities/dynamic-activity.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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 one Dynamic Activity per Worker with RegisterDynamicActivity to handle Activity Types that match no other registered Activity.
toc_max_heading_level: 4
tags:
- Activities
- Go SDK
- Temporal SDKs
---
Expand Down
12 changes: 6 additions & 6 deletions docs/develop/go/activities/execution.mdx
Original file line number Diff line number Diff line change
@@ -1,17 +1,17 @@
---
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
tags:
- Activities
- Go SDK
- Temporal SDKs
- Activities
---

## 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.
Expand Down Expand Up @@ -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).
Expand Down Expand Up @@ -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.
Expand Down
5 changes: 3 additions & 2 deletions docs/develop/go/activities/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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: Activity Definitions, Activity Execution, Timeouts, Standalone Activities, Dynamic Activities, and benign exceptions in the Temporal Go SDK.
toc_max_heading_level: 4
tags:
- Activities
- Go SDK
- Temporal SDKs
---
Expand All @@ -20,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)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand Down Expand Up @@ -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).

Expand Down Expand Up @@ -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.
6 changes: 3 additions & 3 deletions docs/develop/go/activities/timeouts.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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 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
Expand All @@ -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.

Expand Down Expand Up @@ -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.
Expand Down
4 changes: 2 additions & 2 deletions docs/develop/go/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand All @@ -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)
Expand Down
2 changes: 0 additions & 2 deletions docs/develop/java/activities/asynchronous-activity.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down
Loading