From 0338db5e6b0f81bec7703fbce45b387d20143229 Mon Sep 17 00:00:00 2001 From: Eric Engestrom Date: Thu, 9 Jul 2020 01:26:31 +0200 Subject: [PATCH] docs/releasing: improve wording Signed-off-by: Eric Engestrom Part-of: --- docs/releasing.rst | 21 ++++++++------------- 1 file changed, 8 insertions(+), 13 deletions(-) diff --git a/docs/releasing.rst b/docs/releasing.rst index 529dcd62d44..dbaa0e17afb 100644 --- a/docs/releasing.rst +++ b/docs/releasing.rst @@ -261,18 +261,13 @@ Create release notes for the new release ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The release notes are completely generated by the -``bin/gen_release_notes.py`` script. Simply run this script before -bumping the version. The only thing left to do -is add the sha256 sums. +``bin/gen_release_notes.py`` script. Simply run this script **before** +bumping the version. You'll need to come back to this file once the +tarball is generated to add its ``sha256sum``. -Increment the version contained in the file VERSION at Mesa's top-level, -then commit this change. - -Commit these changes and push the branch. - -:: - - git push origin HEAD +Increment the version contained in the file ``VERSION`` at Mesa's top-level, +then commit this change and **push the branch** (if you forget to do +this, ``release.sh`` below will fail). Use the release.sh script from xorg `util-modular `__ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -295,8 +290,8 @@ release notes, and is published in `release-maintainers-keys.asc Add the sha256sums to the release notes ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Edit docs/relnotes/X.Y.Z.rst to add the sha256sum as available in the -mesa-X.Y.Z.announce template. Commit this change. +Edit ``docs/relnotes/X.Y.Z.rst`` to add the ``sha256sum`` as available in the +``mesa-X.Y.Z.announce`` template. Commit this change. Back on mesa master, add the new release notes into the tree ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -- 2.30.2