@@ -207,13 +207,22 @@ <h3 id="common-test-groups">Common Test Groups</h3>
207207tier1.</ p >
208208< p > A brief description of the tiered test groups:</ p >
209209< ul >
210- < li > < p > < code > tier1</ code > : This is the lowest test tier. Multiple
211- developers run these tests every day. Because of the widespread use, the
212- tests in < code > tier1</ code > are carefully selected and optimized to run
213- fast, and to run in the most stable manner. The test failures in
214- < code > tier1</ code > are usually followed up on quickly, either with
215- fixes, or adding relevant tests to problem list. GitHub Actions
216- workflows, if enabled, run < code > tier1</ code > tests.</ p > </ li >
210+ < li > < p > < code > tier1</ code > : This is the most fundamental test tier.
211+ Roughly speaking, a failure of a test in this tier has the potential to
212+ indicate a problem that would affect many Java programs. Tests in
213+ < code > tier1</ code > include tests of HotSpot, core APIs in the
214+ < code > java.base</ code > module, and the < code > javac</ code > compiler.
215+ Multiple developers run these tests every day. Because of the widespread
216+ use, the tests in < code > tier1</ code > are carefully selected and
217+ optimized to run fast, and to run in the most stable manner. As a
218+ guideline, nearly all individual tests in < code > tier1</ code > are
219+ expected to run to completion in ten seconds or less when run on common
220+ configurations used for development. Long-running tests, even of core
221+ functionality, should occur in higher tiers or be covered in other kinds
222+ of testing. The test failures in < code > tier1</ code > are usually followed
223+ up on quickly, either with fixes, or adding relevant tests to problem
224+ list. GitHub Actions workflows, if enabled, run < code > tier1</ code >
225+ tests.</ p > </ li >
217226< li > < p > < code > tier2</ code > : This test group covers even more ground.
218227These contain, among other things, tests that either run for too long to
219228be at < code > tier1</ code > , or may require special configuration, or tests
0 commit comments