From cf776d192b2e373abffa09cc0c1048118ee90239 Mon Sep 17 00:00:00 2001
From: lilianakatrina684-a11y <lilianakatrina684@gmail.com>
Date: Sun, 22 Mar 2026 03:15:04 +0800
Subject: [PATCH] doc: clarify V8 option stability

---
 doc/api/cli.md | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/doc/api/cli.md b/doc/api/cli.md
index b1a0d674ca4ded..7ecc9de1541185 100644
--- a/doc/api/cli.md
+++ b/doc/api/cli.md
@@ -3288,7 +3288,7 @@ certificates instead. These environment variables can be used as workarounds
 if the conventional paths used by the version of OpenSSL Node.js links to are
 not consistent with the system configuration that the users have for some reason.
 
-### `--v8-options`
+### --v8-options
 
 <!-- YAML
 added: v0.1.3
@@ -3296,6 +3296,9 @@ added: v0.1.3
 
 Print V8 command-line options.
 
+The available V8 options are not covered by the Node.js stability guarantees
+and may change or be removed between releases, including when Node.js is
+updated to a newer V8 version.
 ### `--v8-pool-size=num`
 
 <!-- YAML