Skip to content

Commit fb44940

Browse files
authored
Update and rename adaptive-testing.adoc to smarter-testing.adoc
1 parent 73da4b8 commit fb44940

File tree

1 file changed

+23
-23
lines changed

1 file changed

+23
-23
lines changed

docs/guides/modules/test/pages/adaptive-testing.adoc renamed to docs/guides/modules/test/pages/smarter-testing.adoc

Lines changed: 23 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1,36 +1,36 @@
1-
= Adaptive testing
1+
= Smarter Testing
22
:page-badge: Preview
33
:page-platform: Cloud
4-
:page-description: This document describes the adaptive testing feature in CircleCI, which enables only running tests that are impacted by code changes and evenly distributes tests across parallel execution nodes.
4+
:page-description: This document describes the Smarter Testing feature in CircleCI, which enables only running tests that are impacted by code changes and evenly distributes tests across parallel execution nodes.
55
:experimental:
66
:page-noindex: true
77

8-
CAUTION: *Adaptive testing* is available in closed preview. When the feature is made generally available there will be a cost associated with access and usage.
8+
CAUTION: *Smarter Testing* is available in closed preview. When the feature is made generally available there will be a cost associated with access and usage.
99

1010
NOTE: This page is currently in development and will be updated as the feature is developed.
1111

12-
Use adaptive testing to optimize test runs as follows:
12+
Use Smarter Testing to optimize test runs as follows:
1313

1414
* Run only tests that are impacted by code changes.
1515
* Evenly distribute tests across parallel execution nodes.
1616
17-
Adaptive testing reduces test execution time while maintaining test confidence.
17+
Smarter Testing reduces test execution time while maintaining test confidence.
1818

19-
== Is my project a good fit for adaptive testing?
19+
== Is my project a good fit for Smarter Testing?
2020

21-
The following list shows some examples of where adaptive testing can be most beneficial:
21+
The following list shows some examples of where Smarter Testing can be most beneficial:
2222

2323
* Tests that exercise code within the same repository.
24-
* Projects with comprehensive test coverage. The more thorough your tests, the more precisely adaptive testing can identify which tests are impacted by changes.
24+
* Projects with comprehensive test coverage. The more thorough your tests, the more precisely Smarter Testing can identify which tests are impacted by changes.
2525
* Test frameworks with built-in coverage support (Jest, pytest, Go test, Vitest) where generating coverage reports is straightforward.
2626
+
27-
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.
27+
TIP: In codebases with sparse test coverage, Smarter Testing cannot accurately determine which tests cover changed code. This causes the system to run more tests, reducing the benefits of intelligent test selection.
2828

2929
== Limitations
3030

31-
* 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.
32-
* Adaptive testing works best when testing a single deployable artifact. For example, a monorepo with integration tests that span multiple packages/services, especially when services run in separate container, makes coverage generation and consolidation difficult.
33-
* 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.
31+
* 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 Smarter Testing may not be a good fit.
32+
* Smarter Testing works best when testing a single deployable artifact. For example, a monorepo with integration tests that span multiple packages/services, especially when services run in separate container, makes coverage generation and consolidation difficult.
33+
* Smarter 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 Smarter Testing may not be a good fit.
3434

3535
== Key benefits
3636

@@ -40,7 +40,7 @@ TIP: In codebases with sparse test coverage, adaptive testing cannot accurately
4040
* Scale efficiently as test suites grow.
4141

4242
== How it works
43-
Adaptive testing operates through two main components that work together to optimize your test execution:
43+
Smarter Testing operates through two main components that work together to optimize your test execution:
4444

4545
* Dynamic test splitting
4646
* Test impact analysis
@@ -50,7 +50,7 @@ Each component is described in more detail below.
5050
=== Dynamic test splitting
5151
Dynamic test splitting distributes your tests across parallel execution nodes. The system maintains a shared queue that each node pulls from to create a balanced workload.
5252

53-
When you configure parallelism in your job, adaptive testing automatically:
53+
When you configure parallelism in your job, Smarter Testing automatically:
5454

5555
* Retrieves timing data from previous test runs.
5656
* Calculates optimal test distribution across your specified number of parallel nodes.
@@ -293,15 +293,15 @@ options:
293293

294294
If tests are still slower, share the pipeline link in the closed beta slack channel.
295295

296-
== 2. Enable adaptive testing
296+
== 2. Enable Smarter Testing
297297

298-
We recommend following the steps in <<getting-started>> first before enabling the adaptive testing feature to ensure the `discover` and `run` commands are set up correctly.
298+
We recommend following the steps in <<getting-started>> first before enabling the Smarter Testing feature to ensure the `discover` and `run` commands are set up correctly.
299299

300-
The goal of this section is to enable adaptive testing for your test suite.
300+
The goal of this section is to enable Smarter Testing for your test suite.
301301

302302
=== 2.1 Update the test suites file
303303

304-
When using adaptive testing for test impact analysis the following commands are used:
304+
When using Smarter Testing for test impact analysis the following commands are used:
305305

306306
* The `discover` command discovers all tests in a test suite.
307307
* The `run` command runs only impacted tests and a new command.
@@ -497,7 +497,7 @@ The following options are available to be defined in the options map in config:
497497

498498
| `adaptive-testing`
499499
|false
500-
|Enables the adaptive testing features, such as test impact analysis.
500+
|Enables the Smarter Testing features, such as test impact analysis.
501501

502502
| `full-test-run-paths`
503503
a|
@@ -548,7 +548,7 @@ a| * `all` selects and runs all discovered tests, used to run the full test suit
548548
|===
549549
--
550550

551-
== 3. Start using adaptive testing
551+
== 3. Start using Smarter Testing
552552

553553
Now the test suite is set up, test selection is working and the test analysis is up to date with the latest changes from the feature branch that ran the first test analysis.
554554

@@ -658,7 +658,7 @@ options:
658658

659659
== Limitations
660660

661-
The adaptive testing feature has some limitations to consider:
661+
The Smarter Testing feature has some limitations to consider:
662662

663663
*Initial setup period*:: Test impact analysis requires an initial analysis run on all tests before intelligent selection can begin. This first analysis run will be slower than normal test execution.
664664

@@ -782,7 +782,7 @@ When test selection determines that no existing tests are affected by your chang
782782

783783
*Best practice:* Include relevant paths in `full-test-run-paths` to explicitly trigger full test runs for infrastructure changes.
784784

785-
=== How do I know if adaptive testing is working?
785+
=== How do I know if Smarter Testing is working?
786786

787787
Look for these indicators in your CircleCI build output:
788788

@@ -858,7 +858,7 @@ The `analysis-baseline` command will be run just before running analysis. The co
858858

859859
=== What test frameworks are supported?
860860

861-
Adaptive testing is runner-agnostic. We provide default configurations for the following test frameworks:
861+
Smarter Testing is runner-agnostic. We provide default configurations for the following test frameworks:
862862

863863
* Jest (JavaScript/TypeScript)
864864
* gotestsum (Go)

0 commit comments

Comments
 (0)