Skip to content

Standalone Activity documentation#4155

Open
dandavison wants to merge 17 commits intomainfrom
standalone-activity-encyclopedia-entry
Open

Standalone Activity documentation#4155
dandavison wants to merge 17 commits intomainfrom
standalone-activity-encyclopedia-entry

Conversation

@dandavison
Copy link
Contributor

@dandavison dandavison commented Jan 27, 2026

Development branch for Standalone Activity documentation

Standalone Activity is currently in development, and due to reach Pre-release on March 11.

Rendered docs


To run a local server that supports Standalone Activity:

git clone https://github.com/temporalio/cli.git
cd cli
git fetch origin
git checkout release/v1.6.x-standalone-activity
go build ./cmd/temporal
./temporal server start-dev

@vercel
Copy link

vercel bot commented Jan 27, 2026

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

Project Deployment Actions Updated (UTC)
temporal-documentation Ready Ready Preview, Comment Mar 9, 2026 6:06pm

Request Review

@dandavison dandavison force-pushed the standalone-activity-encyclopedia-entry branch from 340f0a0 to 89da3f5 Compare January 27, 2026 23:03
@jsundai jsundai self-assigned this Feb 2, 2026
@jsundai
Copy link
Contributor

jsundai commented Feb 10, 2026

Going to bring in the Job Queue feature page into the PR today - just fyi.

Signed-off-by: Phil Prasek <prasek@gmail.com>
@prasek
Copy link
Contributor

prasek commented Feb 25, 2026

added a commit: refine standalone activity encyclopedia and eval pages.

note there's a placeholder for CLI download URL users will need to use. We'll want to make sure that's used consistently in the dev guides too.

links to the SDK dev guides (Go/Python) are also broken until those other PRs land

@dustin-temporal
Copy link
Contributor

Note: metrics updates for standalone activities should be merged when this PR is merged. That PR is here: #4241

- Priority and fairness - multi-tenant fairness, weighted priority tiers, and safeguards against starvation of lower-weighted tasks
- Visibility - list Activity Executions and view status, retry count, and last error
- Manual completion by ID (or token): ignore activity return and wait for external completion
- Activity metrics - including counts for success, failure, timeout, and cancel
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Activity metrics - including counts for success, failure, timeout, and cancel
- [Activity metrics](/cloud/metrics/openmetrics/metrics-reference.mdx#activity-metrics) - including counts for success, failure, timeout, and cancel

@jsundai for when PR #4241 lands

Copy link
Contributor

@prasek prasek Mar 5, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@jsundai looks like both PRs can be merged together when were ready: #4155 (comment)

@dandavison dandavison changed the title Standalone Activity concept docs Standalone Activity documentation Feb 27, 2026
…ities, fix capitalization, add todo placeholder for python cloud, consistency in sidebar, add clone instructions for python

- Install the latest Temporal CLI

🚧 Please build from development branch: https://github.com/temporalio/cli/tree/release/v1.6.x-standalone-activity
Copy link
Contributor

@prasek prasek Mar 5, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We need the official CLI version with a link to download before these docs are merged

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@dandavison can you add the min recommended CLI and Go SDK versions when available? /cc @yuandrew


This documentation uses source code derived from the [Python sample](https://github.com/temporalio/samples-python/blob/main/hello/hello_standalone_activity.py).

<!-- TODO: Update with actual sample path when available -->
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The sample path above looks good, are there any other changes needed for this TODO?


- Install the latest Temporal CLI

🚧 Please build from development branch: https://github.com/temporalio/cli/tree/release/v1.6.x-standalone-activity
Copy link
Contributor

@prasek prasek Mar 5, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We need the official CLI version with a link to download before these docs are merged

Copy link
Contributor

@prasek prasek Mar 9, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@dandavison can you add the min recommended CLI and Python SDK versions when available?

Copy link
Contributor

@prasek prasek left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overall lgtm, dropped a few comments

@temporalio temporalio deleted a comment from github-actions bot Mar 6, 2026
All code samples now use ClientConfig.load_client_connect_config() instead of
hardcoding Client.connect("localhost:7233"), matching the Go approach. This means
the same code works against both local dev server and Temporal Cloud without
changes — just set environment variables or configure a TOML profile.

The Cloud section is collapsed from ~130 lines of duplicated setup (cert
generation, tcld install, namespace creation, duplicate code samples) to a
concise reference that links to the temporal-client page for full details.

Go matches the Python standalone activities pattern: add an info callout
explaining that all samples use envconfig (so they work against both local
and Cloud without code changes), and collapse the Cloud section from ~95
lines of duplicated setup to a concise env var reference with a link to the
temporal-client page.
@github-actions
Copy link
Contributor

github-actions bot commented Mar 9, 2026

@dandavison dandavison force-pushed the standalone-activity-encyclopedia-entry branch from 0ac9ccb to 4dae2ca Compare March 9, 2026 14:20
@dandavison dandavison marked this pull request as ready for review March 9, 2026 16:36
@dandavison dandavison requested a review from a team as a code owner March 9, 2026 16:36
@github-actions
Copy link
Contributor

github-actions bot commented Mar 9, 2026

📖 Docs PR preview links

@prasek prasek requested a review from jsundai March 9, 2026 16:43
@dandavison dandavison force-pushed the standalone-activity-encyclopedia-entry branch from 0ae8f43 to 9a65e3a Compare March 9, 2026 18:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants