doc: clarify release candidate stability index

panva · RafaelGSS · commit 95e9cabf9d37 · 2025-08-12T09:19:59.000-03:00
PR-URL: #59295 Reviewed-By: Antoine du Hamel <duhamelantoine1995@gmail.com> Reviewed-By: James M Snell <jasnell@gmail.com> Reviewed-By: Rafael Gonzaga <rafael.nunu@hotmail.com> Reviewed-By: Jacob Smith <jacob@frende.me> Reviewed-By: Michaël Zasso <targos@protonmail.com> Reviewed-By: Ruy Adorno <ruy@vlt.sh> Reviewed-By: Luigi Pinca <luigipinca@gmail.com> Reviewed-By: Beth Griggs <bethanyngriggs@gmail.com> Reviewed-By: Claudio Wunder <cwunder@gnome.org>
diff --git 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.
