From e3a1589952769b87860b3b290e6b62e685a52458 Mon Sep 17 00:00:00 2001 From: Antoine du Hamel Date: Wed, 6 Nov 2024 13:51:34 +0100 Subject: [PATCH 1/2] doc: clarify removal of experimental API does not require a deprecation --- doc/api/documentation.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/doc/api/documentation.md b/doc/api/documentation.md index edac7426fe0324..a69db8d4393d9b 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 are typically either graduated to stable, or removed +> without a deprecation cycle. From 16215b4eed9e261b5c64ec13aed71821b50a0627 Mon Sep 17 00:00:00 2001 From: Antoine du Hamel Date: Wed, 6 Nov 2024 20:34:46 +0100 Subject: [PATCH 2/2] fixup! doc: clarify removal of experimental API does not require a deprecation --- doc/api/documentation.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/api/documentation.md b/doc/api/documentation.md index a69db8d4393d9b..c6edb13ad613cd 100644 --- a/doc/api/documentation.md +++ b/doc/api/documentation.md @@ -45,8 +45,8 @@ The stability indexes are as follows: > feedback so that we can know that this feature is ready to be marked as > stable. > -> Experimental features are typically either graduated to stable, or removed -> without a deprecation cycle. +> Experimental features leave the experimental status typically either by +> graduating to stable, or are removed without a deprecation cycle.