Skip to content

docs: add Saga pattern page with sequential, parallel, idempotency, and pitfall examples#179

Closed
TrickSumo wants to merge 1 commit into
aws:mainfrom
TrickSumo:saga-pattern
Closed

docs: add Saga pattern page with sequential, parallel, idempotency, and pitfall examples#179
TrickSumo wants to merge 1 commit into
aws:mainfrom
TrickSumo:saga-pattern

Conversation

@TrickSumo
Copy link
Copy Markdown
Contributor

Closes #160

Summary

Adds a dedicated Saga pattern page under Patterns, as requested in #160.

Changes

New page

docs/patterns/saga-pattern.md covers:

  • Description of the saga pattern
  • Sequential saga example (forward steps + compensating steps in reverse on failure)
  • Parallel saga variant using context.parallel() for independent forward steps
  • Idempotency of compensating steps with warning admonition
  • Two common pitfalls with wrong/correct examples

@yaythomas yaythomas self-requested a review May 12, 2026 09:29
@yaythomas
Copy link
Copy Markdown
Contributor

thanks for the submissions @TrickSumo!

I am reviewing, but this is a bigger one and we're still considering #158, so thank you for your patience while we work through all of that!

Comment on lines +7 to +11
Durable functions are well-suited for sagas because:

- Each step is automatically retried on transient failures
- When compensating actions are made durable steps, they are checkpointed and retried
- If Lambda crashes mid-compensation, execution resumes from the last checkpoint
Copy link
Copy Markdown
Contributor Author

@TrickSumo TrickSumo May 15, 2026

Choose a reason for hiding this comment

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

@yaythomas Should I remove this section?

@TrickSumo TrickSumo closed this by deleting the head repository May 16, 2026
@TrickSumo
Copy link
Copy Markdown
Contributor Author

Deleted by mistake, recreating.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: In review

Development

Successfully merging this pull request may close these issues.

docs: add dedicated Saga / compensation pattern page

2 participants