diff --git a/doc/api/test.md b/doc/api/test.md
index 2dfc05e03cdeec..6881daeab16910 100644
--- a/doc/api/test.md
+++ b/doc/api/test.md
@@ -728,12 +728,12 @@ changes:
   properties are supported:
   * `concurrency` {number|boolean} If a number is provided,
     then that many tests would run in parallel.
-    If truthy, it would run (number of cpu cores - 1)
+    If `true`, it would run `os.availableParallelism() - 1` files in parallel.
     tests in parallel.
     For subtests, it will be `Infinity` tests in parallel.
-    If falsy, it would only run one test at a time.
+    If `false`, it would only run one file at a time.
     If unspecified, subtests inherit this value from their parent.
-    **Default:** `false`.
+    **Default:** `1`.
   * `only` {boolean} If truthy, and the test context is configured to run
     `only` tests, then this test will be run. Otherwise, the test is skipped.
     **Default:** `false`.
@@ -1645,7 +1645,11 @@ changes:
   `fn` does not have a name.
 * `options` {Object} Configuration options for the subtest. The following
   properties are supported:
-  * `concurrency` {number} The number of tests that can be run at the same time.
+  * `concurrency` {number|boolean} If a number is provided,
+    then that many files would run in parallel.
+    If `true`, it would run `os.availableParallelism() - 1` files in parallel.
+    files in parallel.
+    If `false`, it would only run one file at a time.
     If unspecified, subtests inherit this value from their parent.
     **Default:** `1`.
   * `only` {boolean} If truthy, and the test context is configured to run