diff --git a/getting-started/pull-request-lifecycle.rst b/getting-started/pull-request-lifecycle.rst index 5cba5f233..cc89fed58 100644 --- a/getting-started/pull-request-lifecycle.rst +++ b/getting-started/pull-request-lifecycle.rst @@ -233,6 +233,25 @@ For the last two, note the following: change and the original** ``NEWS`` **entry remains valid**, then no additional entry is needed. +Examples +~~~~~~~~ + +The following examples typically **do** need a ``NEWS`` entry: + +* a new function, method, class, or module +* a new HOWTO in the documentation +* the removal of a deprecated feature + +The following examples typically **do not** need a ``NEWS`` entry: + +* a new feature was included in Python 3.13 alpha 1, but got removed in + 3.13 beta 2, before the final release of 3.13 +* a typo fix in the documentation or in a docstring +* the addition of a new test method +* the removal of a private and internal API +* code refactoring of a module with no user-visible effects + + Changes that require "What's New in Python" entries ---------------------------------------------------