AWS durable-execution documentation change
Summary
Restructured documentation with updated testing section links, added new Best Practices section with six sub-topics (determinism, idempotency, state management, step design, pause/resume, code organization), updated navigation and footer.
Security assessment
The changes are organizational and content expansion for durable execution patterns and best practices. No security vulnerabilities, incidents, or weaknesses are mentioned. The added best practices cover general development concerns (determinism, idempotency, state management) but are not explicitly security-focused.
Diff
diff --git a/durable-execution/patterns.md b/durable-execution/patterns.md index e4bf06ae5..4556fc14b 100644 --- a//durable-execution/patterns.md +++ b//durable-execution/patterns.md @@ -66,4 +66,7 @@ Testing - * [ Basic Tests ](../testing/basic-tests/) - * [ Complex Workflows ](../testing/complex-workflows/) - * [ Stores ](../testing/stores/) - * [ Testing Modes ](../testing/testing-modes/) + * [ Runner ](../testing/runner/) + * [ Authoring ](../testing/authoring/) + * [ Assertions ](../testing/assertions/) + * [ API Reference ](../testing/api-reference/) + * [ Workflow Patterns ](../testing/workflow-patterns/) + * [ Cloud Runner ](../testing/cloud-runner/) + * [ SAM CLI ](../testing/sam-cli/) @@ -74,0 +78,8 @@ Patterns +Best Practices + * [ Determinism and Replay ](./best-practices/determinism/) + * [ Idempotency and Retries ](./best-practices/idempotency/) + * [ Manage State ](./best-practices/state/) + * [ Step Design ](./best-practices/step-design/) + * [ Pause and Resume ](./best-practices/pause-resume/) + * [ Code Organization ](./best-practices/code-organization/) + @@ -79 +90 @@ On this page - * In this section + * Best practices @@ -90 +101,3 @@ On this page -Reusable patterns and guidance for common durable function use cases. +Best practices and design patterns for your Durable Execution SDK workflow code. For AWS Lambda service concerns like function versioning and aliases, CloudWatch logs, and X-Ray tracing, see the [AWS Lambda durable functions best practices developer guide](https://docs.aws.amazon.com/lambda/latest/dg/durable-best-practices.html). + +## Best practices¶ @@ -92 +105 @@ Reusable patterns and guidance for common durable function use cases. -## In this section¶ +Best practices for deterministic workflows. @@ -94 +107,6 @@ Reusable patterns and guidance for common durable function use cases. - * [Best Practices](best-practices/) Function design, timeout configuration, naming conventions, and common mistakes to avoid + * [Determinism and replay](best-practices/determinism/) How replay works, which code must stay deterministic, and how to move non-determinism into steps. + * [Idempotency and retries](best-practices/idempotency/) When to use at-most-once versus at-least-once, idempotency tokens, and database patterns that tolerate retries. + * [Manage state](best-practices/state/) Why checkpoint size matters, how to store references instead of payloads, and how to avoid size limits. + * [Step design](best-practices/step-design/) Naming, granularity, decorators, error handling inside steps, and the boundary between orchestration and business logic. + * [Pause and resume](best-practices/pause-resume/) Long waits, callbacks with timeouts, heartbeats, and polling external services with backoff. + * [Code organization](best-practices/code-organization/) Separating business logic from orchestration, using child contexts, and grouping configuration. @@ -98 +116 @@ Reusable patterns and guidance for common durable function use cases. -Back to top [ Previous Testing Modes ](../testing/testing-modes/) [ Next Best Practices ](./best-practices/) +Back to top [ Previous SAM CLI ](../testing/sam-cli/) [ Next Best Practices ](./best-practices/) @@ -100 +118 @@ Back to top [ Previous Testing Modes ](../testing/testing-modes/) [ Next Bes -Copyright © 2026 Amazon Web Services, Inc. or its affiliates. +[Privacy](https://aws.amazon.com/privacy/) | [Site terms](https://aws.amazon.com/terms/) | Cookie preferences | Copyright © 2026 Amazon Web Services, Inc. or its affiliates.