From 90c5bb87e5d7a9988dd5582f2bf12578b9fb9772 Mon Sep 17 00:00:00 2001
From: Michal Nasiadka <mnasiadka@gmail.com>
Date: Tue, 3 Nov 2020 15:46:37 +0100
Subject: [PATCH] doc: Add new-release tool usage to relmgmt

Change-Id: If0e3d35511811c47c4da1689d43e22cb9284d5c2
---
 doc/source/contributor/release-management.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/doc/source/contributor/release-management.rst b/doc/source/contributor/release-management.rst
index 3ee6aab91a..c686c0dfcb 100644
--- a/doc/source/contributor/release-management.rst
+++ b/doc/source/contributor/release-management.rst
@@ -76,6 +76,10 @@ Prior to creating a release candidate:
     * ``git diff --name-only origin/stable/<previous release> --
       releasenotes/``
 
+    .. note::
+       Release notes for backported changes (i.e. already present in the previous,
+       stable branch) will not show in the output.
+
   * example (kolla): https://review.opendev.org/648677/
 
   * example (kolla-ansible): https://review.opendev.org/648685/
@@ -127,6 +131,12 @@ stable branch is cut.
 
   * example (kolla-ansible): https://review.opendev.org/650412
 
+.. note::
+
+   Use the `new-release
+   <https://releases.openstack.org/reference/using.html#using-new-release-command>`__
+   tool for those activities.
+
 After RC1
 ---------