fixup! doc: clarify that features cannot be both experimental and deprecated

aduh95 · aduh95 · commit 44572ae9216d · 2026-03-27T14:27:16.000+01:00
diff --git a/doc/api/documentation.md b/doc/api/documentation.md
@@ -46,7 +46,9 @@ The stability indexes are as follows:
 >   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, by being deprecated, or are removed without a deprecation cycle.
+> graduating to stable, or are removed without a deprecation cycle. In less
+> common cases, if the feature has gotten large adoption in the ecosystem,
+> they can also leave the experimental status by being deprecated.
 
 <!-- separator -->
 

Original file line number	Diff line number	Diff line change
`@@ -46,7 +46,9 @@ The stability indexes are as follows:`
`46`	`46`	`> we can know that this feature is ready to be marked as stable.`
`47`	`47`	`>`
`48`	`48`	`> Experimental features leave the experimental status typically either by`
`49`		`-> graduating to stable, by being deprecated, or are removed without a deprecation cycle.`
	`49`	`+> graduating to stable, or are removed without a deprecation cycle. In less`
	`50`	`+> common cases, if the feature has gotten large adoption in the ecosystem,`
	`51`	`+> they can also leave the experimental status by being deprecated.`
`50`	`52`
`51`	`53`	`<!-- separator -->`
`52`	`54`