Skip to content

Update Java versioning docs for automatic TemporalChangeVersion support#4236

Merged
flippedcoder merged 2 commits intomainfrom
docs/java-versioning-search-attribute
Apr 10, 2026
Merged

Update Java versioning docs for automatic TemporalChangeVersion support#4236
flippedcoder merged 2 commits intomainfrom
docs/java-versioning-search-attribute

Conversation

@bchav
Copy link
Copy Markdown
Contributor

@bchav bchav commented Feb 24, 2026

Summary

  • Documents the new setEnableUpsertVersionSearchAttributes option in WorkflowImplementationOptions (Java SDK v1.30.0+), which automatically upserts the TemporalChangeVersion Search Attribute on getVersion calls
  • Removes the outdated statement that "The Java SDK does not automatically add this attribute"
  • Preserves the manual upsert instructions as a fallback for older SDK versions
  • Also fixes minor code issues in the manual examples (list.appendlist.add, Constants.TEMPORAL_CHANGE_VERSIONTEMPORAL_CHANGE_VERSION)

Why

The Java SDK issue temporalio/sdk-java#587 was closed by PR #2464, adding automatic TemporalChangeVersion support behind an opt-in flag. The docs still stated this wasn't supported, which is incorrect as of v1.30.0.

Checklist

  • Follows STYLE.md guidelines
  • Links to related documentation (search attribute reference page)
  • No new pages added (edited existing page only)
  • No broken links

🤖 Generated with Claude Code

┆Attachments: EDU-5943 Update Java versioning docs for automatic TemporalChangeVersion support

@bchav bchav requested a review from a team as a code owner February 24, 2026 21:48
@vercel
Copy link
Copy Markdown

vercel bot commented Feb 24, 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 10, 2026 3:58pm

Request Review

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Feb 24, 2026

📖 Docs PR preview links

…n support

The Java SDK v1.30.0 added setEnableUpsertVersionSearchAttributes in
WorkflowImplementationOptions, which automatically upserts the
TemporalChangeVersion search attribute on getVersion calls. The docs
previously stated the Java SDK does not support this. Updated to
document the automatic option as the recommended approach while
preserving the manual upsert instructions as a fallback.

Closes temporalio/sdk-java#587

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@flippedcoder flippedcoder merged commit 80779cf into main Apr 10, 2026
9 checks passed
@flippedcoder flippedcoder deleted the docs/java-versioning-search-attribute branch April 10, 2026 16:00
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