Skip to content

Commit a98af52

Browse files
committed
Mention CI for java 8 and windows
1 parent 662ebc9 commit a98af52

File tree

1 file changed

+26
-0
lines changed

1 file changed

+26
-0
lines changed

docs/_docs/contributing/testing.md

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -173,6 +173,32 @@ original expect file, or if the user wants to globally replace all expect files
173173
`scala3-compiler-bootstrapped/test:runMain dotty.tools.dotc.semanticdb.updateExpect`, and compare the changes via version
174174
control.
175175

176+
### Test regimes
177+
178+
Continuous integration, managed by GitHub Actions, does not run all jobs when a pull request is created.
179+
In particular, test jobs for testing under JDK 8 and Windows are not run. Those jobs are run only for the nightly build.
180+
181+
If a PR may fail differentially under either JDK 8 or Windows, the test jobs may be triggered by adding
182+
a special command to the PR comment text:
183+
184+
```
185+
[test_java8]
186+
[test_windows_full]
187+
```
188+
Furthermore, CI tests are bootstrapped. A job to also run tests non-bootstrapped may be triggered manually:
189+
```
190+
[test_non_bootstrapped]
191+
```
192+
A trivial PR, such as a fix for a typo in a comment or when contributing other documentation, may benefit by skipping CI tests altogether:
193+
```
194+
[skip ci]
195+
```
196+
Other jobs which are normally run can also be selectively skipped:
197+
```
198+
[skip community_build]
199+
[skip test_windows_fast]
200+
```
201+
176202
## Troubleshooting
177203

178204
Some of the tests depend on temporary state stored in the `out` directory. In rare cases, that directory

0 commit comments

Comments
 (0)