Approval Workflows
With Approval Workflows, when a DevCycle user wants to change a Feature, they must request a review and approval from a Publisher within their DevCycle organization. Approval Workflows give people greater visibility on Feature changes and act as a safeguard for your team. These review-style approvals mirror common code review workflows, such as pull request (PR) reviews in GitHub.
Anyone with a Publisher, or Owner role can approve a Change Request, regardless of whether or not their review has been requested. Publishers whom the requester selects receive an email notifying them that their review has been requested, as well as an in-dashboard notification on DevCycle's homepage.
The following actions do not trigger an approval request:
- Self-Targeting
- Adding or removing Metrics
Setting Up Approval Workflows for a DevCycle Project
Permissions must be enabled for Organizations to use Approval Workflows. Please contact our support team to get started with Permissions if you wish to use this feature.
Approval Workflows are a Project-level setting within DevCycle.
To enable Approval Workflows in a project:
- Navigate to your chosen Project's settings page and find the Approval Workflows section.
- Select
Enabled
from the dropdown. - You may also choose whether Publishers can skip the approval process and save changes directly without requiring review from another teammate.
- Click
Save
and Approval Workflows will now be active for that project.
Requesting a Review for a Change Request
Once Approval Workflows have been enabled, every team member, regardless of their permission level, will require approval on Feature changes in all environments from a Publisher or Owner within your DevCycle organization.
- Once you've made your desired Feature changes, click on the
Submit Change Request
button at the top-right corner of the Feature page. - Review and confirm the changes displayed in the Review Change modal.
- Enter a brief description that helps your reviewers understand the changes you made.
- Select one or more reviewers from the Reviewers menu and click Submit.
After the Change Request is submitted, the Feature form will be locked for all users until the active Change Request is approved, rejected, or canceled.
Members who do not have permission to approve requests can still view the Change Request at the top of the Feature form.
Force Applying a Change Request as a Publisher
Force applying changes to bypass the review process for Publishers is only available if the "Publishers can skip the review process" setting has been turned on for your Project. This feature is intended to reduce friction for users who have publishing permissions.
The button Force Apply
will appear on the Change Request modal for these users.
If a user chooses to Force Apply
then they are required to include a change description, however they cannot select other reviewers.
Approving or Rejecting a Change Request
- If selected by the requester, reviewers receive an email, an in-app dashboard notification on the Homepage informing them approve your Change Request. Click
Review Change Request
button on the email or navigate to the Feature page. - Once on the Feature Page, click
Review Change Request
to open up the Review Change Request modal.
- If you
Approve and Apply Changes
, the proposed changes will be saved immediately. - If you
Reject
the Change Request, you will need to provide a reason for the rejection that will be sent back to the requester via an email notification.
*Note: Anyone with a Publisher, or Owner can approve a Change Request, regardless of whether or not their review has been requested.
Cancelling a Change Request
As the requester, you can cancel your Change Request in the Review Change Request modal and clicking on Cancel Request
.