From a98af525617e74618d81a25c5acb07fe372fa883 Mon Sep 17 00:00:00 2001 From: Som Snytt Date: Thu, 16 Jun 2022 13:25:13 -0700 Subject: [PATCH] Mention CI for java 8 and windows --- docs/_docs/contributing/testing.md | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/docs/_docs/contributing/testing.md b/docs/_docs/contributing/testing.md index 38f7725cdf3f..a01cdb08f8ab 100644 --- a/docs/_docs/contributing/testing.md +++ b/docs/_docs/contributing/testing.md @@ -173,6 +173,32 @@ original expect file, or if the user wants to globally replace all expect files `scala3-compiler-bootstrapped/test:runMain dotty.tools.dotc.semanticdb.updateExpect`, and compare the changes via version control. +### Test regimes + +Continuous integration, managed by GitHub Actions, does not run all jobs when a pull request is created. +In particular, test jobs for testing under JDK 8 and Windows are not run. Those jobs are run only for the nightly build. + +If a PR may fail differentially under either JDK 8 or Windows, the test jobs may be triggered by adding +a special command to the PR comment text: + +``` +[test_java8] +[test_windows_full] +``` +Furthermore, CI tests are bootstrapped. A job to also run tests non-bootstrapped may be triggered manually: +``` +[test_non_bootstrapped] +``` +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: +``` +[skip ci] +``` +Other jobs which are normally run can also be selectively skipped: +``` +[skip community_build] +[skip test_windows_fast] +``` + ## Troubleshooting Some of the tests depend on temporary state stored in the `out` directory. In rare cases, that directory