Skip to content

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

Open
donald-pinckney wants to merge 1 commit intomainfrom
docs/plugins-side-effect-testing
Open

plugins-guide: concrete patterns for duplicate-side-effect testing#4481
donald-pinckney wants to merge 1 commit 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 Apr 23, 2026 8:51pm

Request Review

@github-actions
Copy link
Copy Markdown
Contributor

📖 Docs PR preview links

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