Skip to content

Fix startUpdate JavaDoc: clarify blocking behavior based on waitForStage - #2992

Open
sachinsharma3191 wants to merge 1 commit into
temporalio:mainfrom
sachinsharma3191:fix/2578-startUpdate-javadoc-async
Open

Fix startUpdate JavaDoc: clarify blocking behavior based on waitForStage#2992
sachinsharma3191 wants to merge 1 commit into
temporalio:mainfrom
sachinsharma3191:fix/2578-startUpdate-javadoc-async

Conversation

@sachinsharma3191

Copy link
Copy Markdown

Summary

  • Remove misleading "asynchronously" from all startUpdate and startUpdateWithStart JavaDoc comments
  • Add note that the method blocks until the waitForStage specified in the options is reached (e.g., COMPLETED causes the call to block until the update finishes)
  • Also fixes minor typo: "firth" → "fifth" in @param arg5 descriptions

Test plan

  • Doc-only change — no behavioral changes
  • Verified all 21 overloads updated consistently
  • No remaining incorrect "asynchronously" in startUpdate/startUpdateWithStart JavaDocs

Fixes #2578

The JavaDoc for all startUpdate and startUpdateWithStart overloads
incorrectly described the methods as "asynchronous". When waitForStage
is set to COMPLETED, startUpdate blocks until the update finishes.

Replace "asynchronously" with a note that the method blocks until
the waitForStage specified in the options is reached.

Fixes temporalio#2578
@sachinsharma3191
sachinsharma3191 requested a review from a team as a code owner August 10, 2026 01:12
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.

startUpdate JavaDoc says "asynchronously" when it may not be

1 participant