From 37c941be052a8b98eb6066cc38f8e30603e4c5d8 Mon Sep 17 00:00:00 2001
From: Antoine du Hamel <duhamelantoine1995@gmail.com>
Date: Fri, 8 Nov 2024 13:02:49 +0000
Subject: [PATCH] doc: clarify removal of experimental API does not require a
 deprecation
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

PR-URL: https://github.com/nodejs/node/pull/55746
Reviewed-By: Moshe Atlow <moshe@atlow.co.il>
Reviewed-By: Chengzhong Wu <legendecas@gmail.com>
Reviewed-By: Gireesh Punathil <gpunathi@in.ibm.com>
Reviewed-By: Ulises Gascón <ulisesgascongonzalez@gmail.com>
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
---
 doc/api/documentation.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/doc/api/documentation.md b/doc/api/documentation.md
index edac7426fe0..c6edb13ad61 100644
--- a/doc/api/documentation.md
+++ b/doc/api/documentation.md
@@ -44,6 +44,9 @@ The stability indexes are as follows:
 >   still occur in response to user feedback. We encourage user testing and
 >   feedback so that we can know that this feature is ready to be marked as
 >   stable.
+>
+> Experimental features leave the experimental status typically either by
+> graduating to stable, or are removed without a deprecation cycle.
 
 <!-- separator -->