From c3c6482c67d1b016a137a66186afae1a9e0202d2 Mon Sep 17 00:00:00 2001
From: Moshe Atlow <moshe@atlow.co.il>
Date: Tue, 30 May 2023 23:53:55 +0300
Subject: [PATCH 1/2] doc: document watch option for node:test run()

---
 doc/api/test.md | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/doc/api/test.md b/doc/api/test.md
index 1dc4b9f4357ccf..32aec6eadbe40a 100644
--- a/doc/api/test.md
+++ b/doc/api/test.md
@@ -744,25 +744,26 @@ changes:
     **Default:** `false`.
   * `files`: {Array} An array containing the list of files to run.
     **Default** matching files from [test runner execution model][].
-  * `setup` {Function} A function that accepts the `TestsStream` instance
-    and can be used to setup listeners before any tests are run.
-    **Default:** `undefined`.
-  * `signal` {AbortSignal} Allows aborting an in-progress test execution.
-  * `timeout` {number} A number of milliseconds the test execution will
-    fail after.
-    If unspecified, subtests inherit this value from their parent.
-    **Default:** `Infinity`.
   * `inspectPort` {number|Function} Sets inspector port of test child process.
     This can be a number, or a function that takes no arguments and returns a
     number. If a nullish value is provided, each process gets its own port,
     incremented from the primary's `process.debugPort`.
     **Default:** `undefined`.
+  * `setup` {Function} A function that accepts the `TestsStream` instance
+    and can be used to setup listeners before any tests are run.
+    **Default:** `undefined`.
+  * `signal` {AbortSignal} Allows aborting an in-progress test execution.
   * `testNamePatterns` {string|RegExp|Array} A String, RegExp or a RegExp Array,
     that can be used to only run tests whose name matches the provided pattern.
     Test name patterns are interpreted as JavaScript regular expressions.
     For each test that is executed, any corresponding test hooks, such as
     `beforeEach()`, are also run.
     **Default:** `undefined`.
+  * `timeout` {number} A number of milliseconds the test execution will
+    fail after.
+    If unspecified, subtests inherit this value from their parent.
+    **Default:** `Infinity`.
+  * `watch` {boolean} Weather to run in watch mode
 * Returns: {TestsStream}
 
 ```mjs

From e293c90115b3d7a4efed7832b89c16bdcc2dde00 Mon Sep 17 00:00:00 2001
From: Moshe Atlow <moshe@atlow.co.il>
Date: Wed, 31 May 2023 11:14:33 +0300
Subject: [PATCH 2/2] Update doc/api/test.md

Co-authored-by: Colin Ihrig <cjihrig@gmail.com>
---
 doc/api/test.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/api/test.md b/doc/api/test.md
index 32aec6eadbe40a..64413bc770fa76 100644
--- a/doc/api/test.md
+++ b/doc/api/test.md
@@ -763,7 +763,7 @@ changes:
     fail after.
     If unspecified, subtests inherit this value from their parent.
     **Default:** `Infinity`.
-  * `watch` {boolean} Weather to run in watch mode
+  * `watch` {boolean} Whether to run in watch mode or not. **Default:** `false`.
 * Returns: {TestsStream}
 
 ```mjs