diff --git a/doc/api/documentation.md b/doc/api/documentation.md
index edac7426fe0324..c6edb13ad613cd 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 -->