From 204018bba621738e7172e3bef161833d7a3265b5 Mon Sep 17 00:00:00 2001
From: RafaelGSS <rafael.nunu@hotmail.com>
Date: Fri, 19 Apr 2024 16:29:40 -0300
Subject: [PATCH] doc: deprecate --experimental-policy

PR-URL: https://github.com/nodejs/node/pull/52602
Reviewed-By: Marco Ippolito <marcoippolito54@gmail.com>
Reviewed-By: Joyee Cheung <joyeec9h3@gmail.com>
Reviewed-By: Moshe Atlow <moshe@atlow.co.il>
Reviewed-By: Benjamin Gruenbaum <benjamingr@gmail.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Michael Dawson <midawson@redhat.com>
---
 doc/api/cli.md         | 4 +++-
 doc/api/permissions.md | 2 +-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/doc/api/cli.md b/doc/api/cli.md
index f08afb737d41b4..46ffc668e2d712 100644
--- a/doc/api/cli.md
+++ b/doc/api/cli.md
@@ -881,6 +881,8 @@ following permissions are restricted:
 added: v11.8.0
 -->
 
+> Stability: 0 - Deprecated: Will be removed shortly.
+
 Use the specified file as a security policy.
 
 ### `--experimental-require-module`
@@ -1519,7 +1521,7 @@ developers may leverage to detect deprecated API usage.
 added: v12.7.0
 -->
 
-> Stability: 1 - Experimental
+> Stability: 0 - Deprecated: Will be removed shortly.
 
 Instructs Node.js to error prior to running any code if the policy does not have
 the specified integrity. It expects a [Subresource Integrity][] string as a
diff --git a/doc/api/permissions.md b/doc/api/permissions.md
index 395e22326d93a8..296d0263feef81 100644
--- a/doc/api/permissions.md
+++ b/doc/api/permissions.md
@@ -27,7 +27,7 @@ If you find a potential security vulnerability, please refer to our
 
 <!-- type=misc -->
 
-> Stability: 1 - Experimental
+> Stability: 0 - Deprecated: Will be removed shortly
 
 <!-- name=policy -->