docs/releasing: improve wording

Signed-off-by: Eric Engestrom <eric@engestrom.ch>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/5833>
This commit is contained in:
Eric Engestrom
2020-07-09 01:26:31 +02:00
committed by Marge Bot
parent ae2d045767
commit 0338db5e6b

View File

@@ -261,18 +261,13 @@ Create release notes for the new release
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The release notes are completely generated by the The release notes are completely generated by the
``bin/gen_release_notes.py`` script. Simply run this script before ``bin/gen_release_notes.py`` script. Simply run this script **before**
bumping the version. The only thing left to do bumping the version. You'll need to come back to this file once the
is add the sha256 sums. tarball is generated to add its ``sha256sum``.
Increment the version contained in the file VERSION at Mesa's top-level, Increment the version contained in the file ``VERSION`` at Mesa's top-level,
then commit this change. then commit this change and **push the branch** (if you forget to do
this, ``release.sh`` below will fail).
Commit these changes and push the branch.
::
git push origin HEAD
Use the release.sh script from xorg `util-modular <https://cgit.freedesktop.org/xorg/util/modular/>`__ Use the release.sh script from xorg `util-modular <https://cgit.freedesktop.org/xorg/util/modular/>`__
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -295,8 +290,8 @@ release notes, and is published in `release-maintainers-keys.asc
Add the sha256sums to the release notes Add the sha256sums to the release notes
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Edit docs/relnotes/X.Y.Z.rst to add the sha256sum as available in the Edit ``docs/relnotes/X.Y.Z.rst`` to add the ``sha256sum`` as available in the
mesa-X.Y.Z.announce template. Commit this change. ``mesa-X.Y.Z.announce`` template. Commit this change.
Back on mesa master, add the new release notes into the tree Back on mesa master, add the new release notes into the tree
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~