Skip to content

Commit 4715d78

Browse files
Update docs/guides/modules/test/pages/adaptive-testing.adoc
Co-authored-by: Rosie Yohannan <rosie@circleci.com>
1 parent 169a7bf commit 4715d78

File tree

1 file changed

+7
-8
lines changed

1 file changed

+7
-8
lines changed

docs/guides/modules/test/pages/adaptive-testing.adoc

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -11,20 +11,19 @@ NOTE: This page is currently in development and will be updated as the feature i
1111

1212
Use adaptive testing to run only tests that are impacted by code changes and evenly distribute tests across parallel execution nodes. Adaptive testing reduces test execution time while maintaining test confidence.
1313

14-
== Where Adaptive Testing works well:
14+
== Use cases for adaptive testing
1515

16-
=== Ideal use cases
17-
* Unit and integration tests that exercise code within the same repository
18-
* Projects with comprehensive test coverage - The more thorough your tests, the more precisely adaptive testing can identify which tests are impacted by changes
19-
* Test frameworks with built-in coverage support (Jest, pytest, Go test, Vitest) where generating coverage reports is straightforward
16+
* Unit and integration tests that exercise code within the same repository.
17+
* Projects with comprehensive test coverage. The more thorough your tests, the more precisely adaptive testing can identify which tests are impacted by changes.
18+
* Test frameworks with built-in coverage support (Jest, pytest, Go test, Vitest) where generating coverage reports is straightforward.
19+
+
20+
TIP: In codebases with sparse test coverage, adaptive testing cannot accurately determine which tests cover changed code. This causes the system to run more tests, reducing the benefits of intelligent test selection.
2021

21-
*Why coverage matters*: In codebases with sparse test coverage, adaptive testing cannot accurately determine which tests cover changed code. This causes the system to run more tests, reducing the benefits of intelligent test selection.
22+
== Limitations
2223

23-
=== Current Constraints
2424
* Generating code coverage data is essential for determining how tests are related to code. If tests are run in a way that makes generating and accessing code coverage data tricky then adaptive testing may not be a good fit.
2525
* Adaptive testing needs to be configured with commands to discover all available tests and run a subset of those tests. If you cannot run commands to discover tests and run a subset of tests on the CLI then adaptive testing may not be a good fit.
2626
* Adaptive testing works best when testing a single deployable unit. A monorepo which performs integration tests across many packages at once may not be a good fit.
27-
2827
== Key benefits:
2928

3029
* Faster CI/CD pipelines through intelligent test selection.

0 commit comments

Comments
 (0)