Skip to content
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.

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

Add documentation for new activity commands - pause/unpause/reset/update #3358

Open
wants to merge 2 commits into
base: main
Choose a base branch
from

Conversation

ychebotarev
Copy link

@ychebotarev ychebotarev commented Feb 18, 2025

What does this PR do?

This PR adds documentation to the following new activity CLI commands:

  • update-options
  • reset
  • pause
  • unpause

Notes to reviewers

EDU-3991

@ychebotarev ychebotarev requested a review from a team as a code owner February 18, 2025 17:36
@CLAassistant
Copy link

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
You have signed the CLA already but the status is still pending? Let us recheck it.

Copy link
Contributor

@drewhoskins-temporal drewhoskins-temporal left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nice, this is all very helpful.
Made a few suggestions to make it even moreso.

Pausing the activity can be undone by using the `temporal activity unpause` command.

Pausing an activity means:
* If the activity is currently waiting for a retry or is running and subsequently fails, it will not be rescheduled until it is unpaused.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please capitalize Activity throughout this. We generally capitalize any words that are referenced in the glossary as key terms.

* If the activity is already paused, calling this method will have no effect.
* If the activity is running and finishes successfully, the activity will be completed.
* If the activity is running and finishes with failure:
* if there is no retry left - the activity will be completed.
Copy link
Contributor

@jsundai jsundai Feb 21, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* if there is no retry left - the activity will be completed.
* If there is no retry left then the Activity will be completed.

The `temporal activity reset` command restarts a running [Activity Execution](/activities#activity-execution) specified by its ID or type.
If there are multiple pending activities of the provided type - all of them will be reset.
Resetting an activity means:
* number of attempts will be reset to 0;
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* number of attempts will be reset to 0;
* The number of attempts will be reset to 0;

@jsundai
Copy link
Contributor

jsundai commented Feb 21, 2025

Did a quick glance, will do a more in-depth review. Great work so far!

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.

4 participants