docs(python): correct 2.0 semantics in four pages - #284
Open
yaythomas wants to merge 1 commit into
Open
Conversation
yaythomas
had a problem deploying
to
ai-pr-review-runtime
September 8, 2026 22:08 — with
GitHub Actions
Failure
yaythomas
had a problem deploying
to
ai-pr-review-runtime
September 8, 2026 22:08 — with
GitHub Actions
Failure
yaythomas
had a problem deploying
to
ai-pr-review-runtime
September 8, 2026 22:23 — with
GitHub Actions
Failure
yaythomas
had a problem deploying
to
ai-pr-review-runtime
September 8, 2026 22:23 — with
GitHub Actions
Failure
yaythomas
had a problem deploying
to
ai-pr-review-runtime
September 8, 2026 22:42 — with
GitHub Actions
Failure
yaythomas
had a problem deploying
to
ai-pr-review-runtime
September 8, 2026 22:42 — with
GitHub Actions
Failure
yaythomas
had a problem deploying
to
ai-pr-review-runtime
September 8, 2026 22:54 — with
GitHub Actions
Failure
yaythomas
had a problem deploying
to
ai-pr-review-runtime
September 8, 2026 22:54 — with
GitHub Actions
Failure
yaythomas
had a problem deploying
to
ai-pr-review-runtime
September 8, 2026 23:06 — with
GitHub Actions
Failure
yaythomas
had a problem deploying
to
ai-pr-review-runtime
September 8, 2026 23:06 — with
GitHub Actions
Failure
yaythomas
had a problem deploying
to
ai-pr-review-runtime
September 8, 2026 23:09 — with
GitHub Actions
Failure
yaythomas
had a problem deploying
to
ai-pr-review-runtime
September 8, 2026 23:09 — with
GitHub Actions
Failure
yaythomas
force-pushed
the
docs/python-2.0-corrections
branch
from
September 8, 2026 23:10
f8bcdae to
a499202
Compare
The default completion config fails the batch on the first failed item, in Python and TypeScript alike. max_concurrency caps in-flight items and a suspended item keeps its slot. A SerDes that fails to deserialize stored polling state fails wait_for_condition. A custom callback SerDes result must serialize with the default SerDes. Behavior moved to shared prose so the language tabs stay symmetric. Java and C# completion-default wording was left untouched; those SDKs were not verified for this change.
yaythomas
force-pushed
the
docs/python-2.0-corrections
branch
from
September 8, 2026 23:11
a499202 to
01750fe
Compare
yaythomas
had a problem deploying
to
ai-pr-review-runtime
September 8, 2026 23:12 — with
GitHub Actions
Failure
yaythomas
had a problem deploying
to
ai-pr-review-runtime
September 8, 2026 23:12 — with
GitHub Actions
Failure
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
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.
Corrects four claims against the released Python SDK 2.0 source (and the JS SDK for the shared map page).
Changes
completion_configbullet claimed the default is lenient ("all items run regardless of failures"). The default fails the batch on the first failed item, verified againstCompletionPolicy.is_tolerance_exceeded(an empty config treats any failure as exceeding tolerance). The TypeScriptcompletionConfigbullet had the same problem ("wait for all items") and is fixed too, verified against the JS handler's completion logic. This is the same error fixed in the SDK docstring in Docs/migration 1x to 2x aws-durable-execution-sdk-python#655 review.max_concurrencybounds in-flight items, not merely "running" items: a suspended item (awaiting an invoke or callback) keeps its slot until it completes.initialState.wait_for_callbackruns in a child context that serializes the result with the default SerDes, so a custom SerDes return value must also serialize with the default SerDes, or the child raisesSerDesError.Not changed
Java and C# completion-default wording on the map page. Those SDKs were not verified for this change; if their defaults are also fail-fast, the same one-line fix applies.
All claims verified against SDK source:
CompletionPolicyinconcurrency/models.py, the coordinator loop inconcurrency/executor.py,operation/wait_for_condition.py, andoperation/callback.py/wait_for_callback_handler.