aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--docs/api-stability.rst4
1 files changed, 4 insertions, 0 deletions
diff --git a/docs/api-stability.rst b/docs/api-stability.rst
index 53669b0f..7ba1d426 100644
--- a/docs/api-stability.rst
+++ b/docs/api-stability.rst
@@ -49,3 +49,7 @@ entirely. In that case, here's how the process will work:
In short, code that runs without warnings will always continue to work for a
period of two releases.
+
+From time to time, we may decide to deprecate an API that is particularly
+widely used. In these cases, we may decide to provide an extended deprecation
+period, at our discretion.