Skip to content

docs(csharp): document the per-operation serializer override (Step/Callback/Invoke/WaitForCondition/ChildContext + Map/Parallel ItemSerializer) - #279

Open
GarrettBeatty wants to merge 2 commits into
aws:mainfrom
GarrettBeatty:per-operation-serializer-docs
Open

GarrettBeatty wants to merge 2 commits into
aws:mainfrom
GarrettBeatty:per-operation-serializer-docs

Conversation

@GarrettBeatty

Copy link
Copy Markdown
Contributor

Summary

Documents the .NET per-operation serializer override on the C# tabs of the serialization reference. Companion to aws/aws-lambda-dotnet#2555.

  • serialization.md — C# tabs now cover the per-operation Serializer on StepConfig/CallbackConfig (and note it reuses ILambdaSerializer, so no new SerDes interface), and the ItemSerializer on MapConfig/ParallelConfig for per-item/branch results (the aggregate batch envelope is SDK-internal, so there is no whole-result serializer).
  • StepConfigExample.cs / CallbackConfigExample.cs / MapConfigExample.cs — updated to demonstrate setting the per-operation serializer.

Notes

Docs-only. Pairs with the SDK feature PR aws/aws-lambda-dotnet#2555.

The .NET SDK now supports an optional per-operation `Serializer` (an ILambdaSerializer)
on StepConfig, CallbackConfig, InvokeConfig, WaitForConditionConfig<TState>, and
ChildContextConfig; when null the globally-registered serializer is used.

Update the C# tabs on the serialization page (Default serialization, SerDes interface,
StepConfig, CallbackConfig) and the StepConfigExample/CallbackConfigExample examples.
Map/Parallel C# tabs left as-is pending two-level (item + whole-result) support.
MapConfig<TItem> and ParallelConfig now expose ItemSerializer for each item/branch result;
the aggregated batch envelope is SDK-internal and not user-serialized (no whole-result
serializer). Update the Map/Parallel C# tab and MapConfigExample.
@GarrettBeatty
GarrettBeatty marked this pull request as ready for review September 8, 2026 18:46
@GarrettBeatty
GarrettBeatty temporarily deployed to ai-pr-review-runtime September 8, 2026 18:46 — with GitHub Actions Inactive
zhongkechen added a commit that referenced this pull request Oct 28, 2026
Document missing operation config signatures, incremental parallel
branches, custom subtype rules, terminal serializer failures, and local
checkpoint-token omission for Core 2.2.0 and Testing 1.1.0.

Leave the serialization guide and its examples to PRs #279 and #280.
Keep shared prose and other language updates in PR #300. All remaining
Markdown changes are inside C# tabs; no file overlaps #279 or #280.

Validate formatting, spelling, snippets, vendored assets, rendered links,
and a clean Zensical build. Retained examples match the previously
compiled and runtime-checked versions.

This branch had an error being deployed

1 failed and 1 inactive deployments
ai-pr-review-runtime — 4b3aeefb Deployed Sep 8, 2026 by GarrettBeatty via ai-pr-review / Codex review / Generate Codex review #107
ai-pr-review — 4b3aeefb Deployed Sep 8, 2026 by GarrettBeatty via ai-pr-review / Approve AI PR review #107
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant