diff --git a/committing.rst b/committing.rst --- a/committing.rst +++ b/committing.rst @@ -101,8 +101,9 @@ ------------ Almost all changes made to the code base deserve an entry in ``Misc/NEWS``. -The ``What's New in Python`` document is the place for more subjective -judgments of the "importance" of changes. There are two notable exceptions +If the change is particularly interesting for end users (e.g. new feature or +significative improvements), an entry in the ``What's New in Python`` document +(in ``Doc/whatsnew/``) should be added as well. There are two notable exceptions to this general principle, and they both relate to changes that *already* have a NEWS entry, and have not yet been included in any formal release (including alpha and beta releases). These exceptions are: