docs: testing section

Replace the testing documentation with a language-neutral section covering the local runner, authoring a test, inspecting operations, the full API surface, workflow patterns, cloud runner, and SAM CLI. Every section now has TypeScript, Python, and Java tabs with real, verified examples from the actual testing SDK sources.

Structure

Add runner.md, authoring.md, assertions.md, api-reference.md, workflow-patterns.md, cloud-runner.md, sam-cli.md.
Drop basic-tests.md, complex-workflows.md, stores.md, testing-modes.md, write-tests.md, test-operations.md, test-workflows.md, testing-tools.md, run-in-cloud.md, and the corresponding examples directories.
Reorder the nav to Runner, Authoring, Assertions, API Reference, Workflow Patterns, Cloud Runner, SAM CLI.

Highlights

Document DURABLE_EXECUTION_TIME_SCALE for the Python testing SDK under Authoring / Skip time in tests, with cross-links from the Long waits workflow pattern and the API reference Control time section.
API reference reorganised by intent verbs (Create a runner, Run the handler, Drive callbacks, etc.) with explicit anchors on duplicated Cloud-side headings so in-page links resolve.
Cloud runner page regrouped so Deploy, Configure polling, and IAM permissions live under Set up the cloud runner, and each troubleshooting tip has its own heading.
Use the correct JS testing package name (@aws/durable-execution-sdk-js-testing).
Verified every method, argument, type, and return value against the TS, Python, and Java SDK and testing SDK sources.
Verified the SAM CLI commands against sam –help locally.

Closes #24 Closes #25 Closes #44 Closes #45 Closes #46 Closes #47 Closes #50 Closes #62 Closes #63 Closes #64 Closes #68 Closes #80 Closes #81 Closes #82 Closes #86 Closes #133

AWS Lambda durable functions developer documentation source

This repository contains the source for the AWS Lambda Durable Execution SDK documentation website at https://docs.aws.amazon.com/durable-execution, providing comprehensive guides and references for building resilient, long-running applications with AWS Lambda durable functions across multiple programming languages.

Repository Structure

docs/                                    # Documentation source files
examples/                                # Code source files for code-blocks in docs/
aws-lambda-durable-functions-power/      # Kiro power for AI assistance

Documentation source

The docs/ directory contains the Markdown source files that power the documentation site.

Code examples are in examples/, organized by language (typescript/, python/, java/) and mirroring the docs folder hierarchy.

Examples are embedded into documentation pages using snippet syntax — see the Contributing Guide for details.

Getting started with the docs

Zensical builds this site from Markdown to HTML.

To preview locally:

python -m venv ~/.venvs/zensical
source ~/.venvs/zensical/bin/activate
pip install zensical

# Live preview with hot-reload
zensical serve

For the full authoring workflow — adding code samples, formatting conventions, commit messages, and pull request process — see CONTRIBUTING.md. For Markdown formatting syntax, please see the Authoring Guide.

Kiro Power

This repository includes a Kiro power that provides AI-assisted guidance for building durable functions. The power includes:

Replay model rules and best practices
Step operation patterns
Error handling strategies
Testing patterns
Deployment templates

See aws-lambda-durable-functions-power/ for details.

Resources

Feedback & Support

We welcome feedback and contributions:

Issues: Report documentation bugs or request improvements via GitHub Issues
Discussions: Ask questions and share ideas in GitHub Discussions
AWS Support: For AWS Lambda service issues, contact AWS Support

Contributing

We welcome contributions! Please see CONTRIBUTING.md for details on how to contribute to the documentation.

Security

See CONTRIBUTING for more information on reporting security issues.

License

This project is licensed under the Apache-2.0 License. See the LICENSE file for details.