docs: add error handling concepts#4605
Merged
Merged
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Contributor
📖 Docs PR preview links |
…on-failures - Add PHP to SDK base class list and add "for example" qualifier - Convert Task vs Execution failures section to comparison table - Remove detecting-application-failures.mdx (content superseded by failures-and-error-handling landing page) - Rename sidebar labels to "Detecting Activity failures" and "Detecting Workflow failures" - Add redirect from old page to new landing page - Update encyclopedia index link
- Define Temporal failures as SDK error types that surface to application code, distinct from platform failures - Clarify that platform failures never produce Temporal failure objects - Scope the failure types table explicitly as Temporal failure types
jsundai
approved these changes
Jun 10, 2026
|
Deployment failed with the following error: Learn More: https://vercel.com/docs/concepts/projects/project-configuration |
- Rename error-handling-strategy to error-handling - Add cross-links to Retry Policy, Application Failure, detecting failures, idempotency, and use cases pages - Trim Saga section to brief description with link out - Update all references in sidebar and encyclopedia pages
yuandrew
reviewed
Jun 11, 2026
| Do not wrap Application Failures in generic language errors (such as `Error` in TypeScript, `Exception` in Python, or `fmt.Errorf` in Go), as this causes the SDK to treat the error as a new, retryable failure. | ||
| ::: | ||
|
|
||
| This behavior is consistent across all SDKs (Go, Java, TypeScript, Python, and .NET). |
| ### Workflow Execution failures | ||
|
|
||
| An Activity failure does not directly cause a Workflow Execution failure. | ||
| If an Activity fails and the error is not handled in the Workflow code (or is intentionally re-raised), the Workflow Execution fails. |
Contributor
There was a problem hiding this comment.
is not handled in the Workflow code
Not sure if it's just me, but this seems a little vague. Maybe it'd be more clear to also state "not handling" means letting the activity error propagate out of the WF function?
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What does this PR do?
Notes to reviewers
┆Attachments: EDU-6408 docs: add error handling concepts