Skip to content

Commit 673ecc1

Browse files
authored
Update dry-run-mode.md
1 parent 204967e commit 673ecc1

File tree

1 file changed

+14
-5
lines changed

1 file changed

+14
-5
lines changed

docs/dry-run-mode.md

Lines changed: 14 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,17 +2,26 @@
22
title: How to Test gitStream Automations
33
description: Use gitStream dry-run mode to test your automations before implementing them.
44
---
5+
56
# How to Test Your Automation
67

7-
By default, gitStream runs all applicable automations for every new PR and changes to existing PR. If you want to test and experiment with new rules, gitStream supports a dry-run mode that will avoid changing your PRs. When you commit changes to any CM files found inside your repo's `.cm/` directory, gitStream will switch to dry-run mode.
8+
Testing your gitStream automations ensures they work as expected before applying them to your live pull requests. gitStream provides two easy ways to safely test your automations:
9+
10+
### 1. Dry Run Mode
811

9-
In dry-run mode, gitStream won't execute any automation rules on the PR. Instead, gitStream will try to parse all applicable automation rules and show an error in case of failure. When there are other changes outside the `cm` files, gitStream will post a comment to the PR discussion describing the actions to be taken for those changes. A new comment will be added after every new commit.
12+
Dry Run mode is automatically enabled whenever you open a PR that modifies any of your `.cm` automation files. In Dry Run mode:
1013

11-
![dry-run mode](/screenshots/dry-run-mode.png)
14+
- gitStream evaluates all automations without executing them.
15+
- Results are added as comments on your pull request, showing exactly what actions would have occurred.
16+
- Each new commit triggers an updated comment describing the changes.
1217

1318
!!! note
19+
While in Dry Run mode, no automation changes actually take effect. To apply your automations, merge your PR after validation.
20+
21+
If you encounter issues while testing, refer to our [Troubleshooting page](troubleshooting.md) for guidance.
1422

15-
When in dry-run mode, incoming changes to the CM files are ignored. In other words, new automations and configurations will only take effect once you merge the PR.
23+
### 2. Using the Playground
1624

17-
Once you are satisfied with the results, you can merge your CM changes into the main branch to enable the new configurations.
25+
You can also test automations interactively using the [gitStream Playground](playground.md). The Playground offers an intuitive environment to preview how automations behave, allowing you to instantly adjust and perfect your rules.
1826

27+
Select the method most convenient for your workflow, or use both methods together for comprehensive testing. Once satisfied with the results, merge your `cm` changes into the main branch to enable the new automations.

0 commit comments

Comments
 (0)