Skip to content

plugins-guide: concrete patterns for duplicate-side-effect testing#4481

Merged
brianmacdonald-temporal merged 2 commits intomainfrom
docs/plugins-side-effect-testing
May 4, 2026
Merged

plugins-guide: concrete patterns for duplicate-side-effect testing#4481
brianmacdonald-temporal merged 2 commits intomainfrom
docs/plugins-side-effect-testing

Conversation

@donald-pinckney
Copy link
Copy Markdown
Contributor

@donald-pinckney donald-pinckney commented Apr 23, 2026

Summary

  • Replaces the vague "Check for duplicate side effects or other types of failures" line in the plugins guide with two concrete, language-agnostic patterns.
  • Motivated by recent experience writing side-effect-replay tests for the temporal-spring-ai plugin, where an execution-counter-based test would have been flaky under activity retries — exactly the failure mode the old text did nothing to warn about.

Test Plan

  • Preview renders on docs.temporal.io build.

┆Attachments: EDU-6259 plugins-guide: concrete patterns for duplicate-side-effect testing

The previous text ("Check for duplicate side effects or other types of
failures") did not give readers enough to act on. Retrying activities
can cause a simple execution counter to flake even when the plugin is
correct, so replace the vague line with two patterns that are invariant
under activity-task retries: counting ActivityTaskScheduled events in
history, or accumulating activity IDs in a set.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@donald-pinckney donald-pinckney requested a review from a team as a code owner April 23, 2026 20:50
@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 23, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
temporal-documentation Ready Ready Preview, Comment May 4, 2026 8:17pm

Request Review

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 23, 2026

📖 Docs PR preview links

@brianmacdonald-temporal brianmacdonald-temporal merged commit 709bc4a into main May 4, 2026
10 checks passed
@brianmacdonald-temporal brianmacdonald-temporal deleted the docs/plugins-side-effect-testing branch May 4, 2026 20:17
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.

2 participants