diff --git a/doc/getting-started-guide/faq.rst b/doc/getting-started-guide/faq.rst index 0b694085804..4f5795882d9 100644 --- a/doc/getting-started-guide/faq.rst +++ b/doc/getting-started-guide/faq.rst @@ -423,7 +423,7 @@ How stable is Xarray's API? Xarray tries very hard to maintain backwards compatibility in our :ref:`api` between released versions. Whilst we do occasionally make breaking changes in order to improve the library, -we try to `signpost changes `_ with ``DeprecationWarnings`` for many months in advance. +we `signpost changes `_ with ``DeprecationWarnings`` for many releases in advance. (An exception is bugs - whose behaviour we try to fix as soon as we notice them.) Our `test-driven development practices `_ help to ensure any accidental regressions are caught. This philosophy applies to everything in the `public API `_.