diff --git a/doc/api/documentation.md b/doc/api/documentation.md
index c6edb13ad613cd..6938ac40a21374 100644
--- a/doc/api/documentation.md
+++ b/doc/api/documentation.md
@@ -41,9 +41,9 @@ The stability indexes are as follows:
 >   minimum viability.
 > * 1.2 - Release candidate. Experimental features at this stage are hopefully
 >   ready to become stable. No further breaking changes are anticipated but may
->   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.
+>   still occur in response to user feedback or the features' underlying
+>   specification development. 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.