Skip to content

docs(serialization): document first-run round trip and retryable serdes error #275

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
yaythomas merged 2 commits into from
Sep 8, 2026
+10 −0
Merged

docs(serialization): document first-run round trip and retryable serdes error #275

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
e271950
docs(serialization): document first-run round trip and retryable serd…
ayushiahjolia Aug 31, 2026
6e588b2
docs: simplify round-trip serialization
yaythomas Sep 8, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions docs/sdk-reference/state/serialization.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,16 @@ the step result automatically.
--8<-- "examples/csharp/sdk-reference/serialization/Walkthrough.cs"
```

## Round-trip serialization

The SDK round-trips an operation result by serializing and then deserializing it
before returning it on the first run. This round trip ensures that the first run
returns the same value that replay reconstructs from the operation's checkpoint.

A serializer/deserializer pair should preserve the value across a round trip.
`deserialize(serialize(value))` should be equivalent to `value`. If it is not,
the round trip will change the operation result.

## Lambda handler serialization

The Durable Execution SDK SerDes only applies to durable operation results. It does not
Expand Down
Loading