Refine quick-reference explanation of NEWS entries

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Co-authored-by: Carol Willing <2680980+willingc@users.noreply.github.com>

Author: 3 people

getting-started/pull-request-lifecycle.rst

@@ -240,13 +240,20 @@ in the "What's New in Python" entry.
     A change that needs an entry in "What's New in Python"
     is very likely not suitable for inclusion in a maintenance release.
 
+.. _news-entry-howto:
+
 How to add a NEWS entry
 -----------------------
 
 ``NEWS`` entries go into the ``Misc/NEWS.d`` directory as individual files. The
 ``NEWS`` entry can be created by using `blurb-it <https://blurb-it.herokuapp.com/>`_,
 or the :pypi:`blurb` tool and its ``blurb add`` command.
 
+.. tip::
+
+   You can read more about ``blurb`` in its
+   `repository <https://github.com/python/blurb>`__.
+
 If you are unable to use the tool, then you can create the ``NEWS`` entry file
 manually. The ``Misc/NEWS.d`` directory contains a sub-directory named
 ``next``, which contains various sub-directories representing classifications

getting-started/quick-reference.rst

@@ -114,19 +114,15 @@ Document your changes
 ---------------------
 
 Many changes deserve a NEWS entry which documents what changed.
+For more information on how and when to write news entries,
+see :ref:`"Updating NEWS and What's New in Python" <news-entry>`.
 
-Add a News entry into the ``Misc/NEWS.d/`` directory as individual file.
-The news entry can be created by using
-`blurb-it <https://blurb-it.herokuapp.com/>`__,
-or the :pypi:`blurb` tool and its ``blurb add`` command.
-
-.. tip::
-
-   You can read more about ``blurb`` in its
-   `repository <https://github.com/python/blurb>`__.
+A news entry can be created locally with the :pypi:`blurb` tool
+and its ``blurb add`` command or online after a pull request has
+been opened with blurb-it <https://blurb-it.herokuapp.com/>__.
 
-For more information on writing news entries,
-see :ref:`"Updating NEWS and What's New in Python" <news-entry>`.
+For more information about how to create news entries, see
+:ref:`"How to add a NEWS entry" <news-entry-howto>`.
 
 Create pull requests
 --------------------